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1.  INTRODUCTION 


1.1  Background 

In  a systems  generated  electromagnetic  pulse  (SGEMP)  test 
progrcim,  time-history  representations  of  electrical  responses  at  various 
critical  nodes  within  a test  object  are  provided  to  analysts  for  evalu- 
ation. Past  methods  of  acquiring  and  recording  these  response  waveforms 
involved  the  use  of  oscilloscopes  and  cameras,  the  waveforms  being  cap- 
tured on  Polaroid  film.  Analysis  was  frequently  conducted  by  use  of  a 
digital  computer.  This  analysis  required  that  the  analog  waveforms  be 
digitized  into  a computer-compatible  digital  format.  Several  types  of 
errors,  as  well  as  the  time  delay  in  processing  the  data,  are  inherent 
in  the  manual  digitization  of  oscillographs.  For  example,  as  the 
digitizer  operator  becomes  fatigued  (after  digitizing  several 
oscillograms) , he  is  likely  to  move  the  cursor  in  such  a way  that 
extraneous  high  frequencies  are  introduced  into  the  waveform  being 
digitized.  The  aimount  of  error  introduced  is  directly  relatable  to  the 
oscillograph  trace  width  (bloom)  and  the  trace  derivative ^ (steepness  of 
slope) . 


This  report  presents  a new  method  for  capturing  and  processing 
complex  SGEMP  transients.  The  method  is  incorporated  into  an  SGEMP 
Transportable  Automated  Recording  System  (STARS) . It  reduces  manual 
data  handling  significantly  (a  major  source  of  errors) ; outputs  data  as 
computer -compatible  magnetic  tapes,  annotated  hard  copies,  or  looth;  and 
lessens  the  manpower  requirements  for  data  acquisition  and  processing 
personnel.  Thus,  the  STARS  enhances  SGEMP  data  accuracy  and  reliability 
through  elimination  of  hand  digitization  and  through  better  signal 
recording  resolution,  while  substantially  reducing  test  operational 
costs.  This  report  is  a direct  replacement  for  HDL-TR-1817,  SKYNET 
Applications  Software  Package  (SASP)  Operator's  and  User's  Handbook  by 
Walter  J.  Scott  and  John  R.  Hiller  ' (August  1977).  It  reflects  major 
changes  and  additions  which  have  been  incorporated  into  SASP. 

1.2  Overview 


The  content  of  this  handlaook  is  directed  towards  STARS 
operators  and  data  users,  the  text  being  chiefly  concerned  with  the 
description  of  the  SKYNET  Applications  Software  Package  (SASP) . A brief 
synopsis  of  each  section  follows. 

Section  2 is  a complete,  detailed  presentation  of  system 
calibration  and  data  files.  A thorough  understanding  of  file 


^Data  Reduction  Planning  and  Coordination,  EGSG,  Rlburguergue , NM 
(1972). 


structures — their  content  and  usage — is  basic  to  understanding 
subsequent  sections.  Through  familiarization  with  the  various  file 
entries,  the  user  can  gain  an  appreciation  for  what  information  he  must 
provide  the  system  before  testing  can  take  place,  as  well  as  for  the 
structure  of  the  data  bank. 

In  section  3,  user  input  requirements  are  described  in  detail. 
Sections  3.2  and  3.3  provide  the  operator  with  the  knowledge  needed  to 
run  the  STARS  console  terminal  and  generate  or  modify  the  system  files. 
The  main  operation  and  control  program,  indirect  command  file  TESTSEQ, 
is  presented  in  section  3.4.1.  Modular  in  construction,  SASP  is 
composed  of  well-defined  programs  that  function  independently  of  one 
another;  however,  the  order  in  which  they  are  executed  is  important. 
Section  3.4,2  discusses  some  of  the  do's  and  don'ts  for  running  single 
programs  in  the  manual  mode. 

The  raw  data  acquired  from  the  transient  digitizer  is  not  in  a 
form  compatible  for  processing  by  digital  computer.  Usually,  there  is 
an  overabundance  of  data  describing  the  waveform.  Sometimes,  there  is  a 
lack  of  data  describing  certain  portions  of  the  waveform.  It  is  the 
task  of  the  normalization  procedure  (sect.  4.1)  to  process  these  raw 
data,  with  their  excesses  cind  deficiencies,  and  to  obtain  from  the  raw 
data  a more  usable  presentation  of  the  waveform. 

The  STARS  operator  is  tasked  with  reviewing  the  data  for 
quality  and  completeness.  He  performs  data  evaluation  (sect.  4.2) 
independently  of  the  data's  context  to  the  experiment.  Rather,  data  are 
examined  to  identify  hardware  relatable  problems,  e.g.,  data  exceeding 
the  digitizer  writing  rate.  Section  4.3  presents  a typical  production 
run  including  user  output  plots  and  tables.  Section  4 concludes  with  a 
discussion  of  data  storage  and  retrieval. 

Section  5 summarizes  each  SASP  module;  the  indirect  command 
file,  program,  and  subroutines.  These  summaries,  when  used  with  the 
flowcharts  (sect.  3.4.1)  and  the  discussion  that  follows,  provide  an 
overview  of  the  data  taking.  A more  detailed  explication  of  the  modules 
may  be  found  in  the  SASP  Programmers'  Handbook .2 

The  SASP  software  was  developed  for  two  reasons ; 

a.  To  control  the  Harry  Diamond  Laboratories  optical  system, 
the  calorimeter  data  acquisition  channels,  and  the  Tektronix  R7912 
transient  digitizers. 


^Robert  Puttcamp,  SKYNET  Applications  Software  Package  (SASP) 
Programmers’  Handbook,  Version  2,  Harry  Diamond  Laboratories  TR-1844 
(February  1978) . 


8 


b.  To  record,  process,  store,  and  reproduce  SGEMP  test  data. 

To  appreciate  many  of  the  software  tasks  and  to  obtain  an 
overview  of  the  entire  STARS  operation,  a brief  presentation  of  the 
data-taking  sequence  is  now  developed. 

Figure  1 is  a STARS  system  block  diagram.  Prior  to  any  data 
taking,  the  STARS  operator  must  generate  the  system  files  by  typing  in 
the  user-supplied  data  for  the  probes,  sensors,  devices,  cables,  etc., 
to  be  used  in  the  experiment.  This  information  is  input  at  the  main 
console  graphic  display  Tektronix  R4010  cathode  ray  tube  terminal  and 
stored  on  disc  unit  No,  0 (DKO:),  a Digital  Equipment  Corp.  (DEC)  RKll 
disc.  This  is  designated  the  "system"  disc  and  contains  the  system 
calibration  and  configuration  files,  the  DEC  RSX-llM  operating  system 
and  the  SASP  program  files.  Disc  unit  No.  1 contains  the  shot  data 
files,  work  files  used  by  the  Versatec  plotting  package  and  user 
terminal  storage. 

Once  the  data  channels  are  completely  defined,  they  are  "known" 
to  the  system.  Any  calculations  on  the  data  regiiiring  probe  sensitivity 
factors,  time  base  settings,  or  any  other  parameter  can  be  made  by 
retrieving  the  entry  from  the  appropriate  system  file.  The  process  of 
data  acquisition  can  now  proceed. 

The  first  step  in  acquiring  data  is  to  adjust  the  knob  settings 
on  the  digitizers.  The  Tektronix  R632  television  (TV)  monitors  present 
a visual  display  to  aid  the  operator  in  the  adjustment  of  the  vertical 
and  horizontal  baseline  positions,  as  well  as  the  intensity  settings. 
The  operator  can  adjust  them  by  running  the  program  KNOB  and  making  the 
required  adjustments.  An  operations  control  file,  TESTSEQ,  itself 
composed  of  individual  command  lines,  allows  interactive  control  of  the 
entire  data-taking  sequence.  Then  program  BASE  is  run  to  acquire 
background  data  from  each  digitizer.  These  data  are  stored  on  DKl:  in 
the  file  named  MAIN.DAT.  Program  BASE  may  be  repeated  if  errors  have 
been  flagged.  (Error  flags  are  discussed  in  app  A.)  Otherwise,  the 
operator  continues  by  acquiring  calibration  signals  from  the  calibration 
generators  located  inside  the  optical  transmitters.  Program  CAL 
accomplishes  the  entire  calibration  sequence,  including  automatic  turn 
on  of  the  optical  equipment  and  triggering  of  the  digitizers.  Program 
CAL  data  are  then  plotted  on  the  terminal  for  evaluation  by  the  STARS 
operator.  Again,  the  flexible  TESTSEQ  indirect  command  file  permits 
looping  back  to  reacquire  these  calibration  waveforms  if  desired.  The 
next  program,  PREDAT,  prepares  the  system  for  the  actual  data  shot. 

Program  PREDAT  sends  commands  to  all  digitizers  and  places  them 
in  the  proper  mode  for  transient  recording.  (App  B discusses  these 
commands  in  detail.)  The  acquisition  and  storage  of  raw  digitizer  data 
eind  the  acquisition,  reduction,  and  storage  of  calorimeter  data  are  then 
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performed  by  programs  DATAPC,  CONDAT,  and  MORDAT.  Program  DATAPC  also 
turns  on  the  optical  transmitters  and  sets  their  programmable 
attenuators.  As  shovm  in  figure  1,  the  interrupt  trigger,  is 

generated  by  an  x-ray  detector  source  and  transmitted  over  a dedicated 
optical  trigger  link.  It  does  so  after  program  CONDAT  has  reached  the 
wait  mode  signified  by  the  message  "WAITING  FOR  TRIGGER."  The  trigger, 
initiated  by  the  simulator  firing,  is  used  to  begin  calorimeter  data 
acquisition  and  to  start  the  sweep  for  each  digitizer.  Sensor  data  are 
transmitted  through  the  optical  data  links,  where  they  are  recorded  by 
the  digitizer's  internal  memory  for  a brief  period  before  being 
transferred  to  DKl ; . 

Five  steps  remain: 

a.  To  normalize  the  data  (sect.  4.1) 

b.  To  scale  the  data  (program  SCALE,  sect.  3.2) 

c.  To  mark  the  data  parameters  (program  MARK,  sect.  4.2.4) 

d.  To  provide  graphical  and  tabular  output  for  the  data  user 
(sect,  4.3) 

e.  To  store  the  data  on  magnetic  tape  (sect.  4.4) 

Section  5 includes  a brief  summary  of  all  SASP  programs.  Detailed 
program  descriptions  may  be  found  in  the  SASP  Programmers'  Handbook.^ 


2 . DATA  FILES 

2 . 1 Introduction 

System  files  are  divided  into  three  classifications:  calibra- 
tion, configuration,  and  data.  Calibration  files  contain  pertinent 
specifications  on  the  measurement  channel  hardware — sensors,  probes, 
optical  data  links,  attenuators,  baluns,  etc.  The  system  configuration 
file  stores  all  the  information  needed  to  uniquely  define  the  physical 
variables  of  the  experiment  at  a given  moment  in  time.  In  general,  the 
SYSCON.DAT  file  is  unique  for  any  shot;  however,  if  no  variables  are 
changed  between  shots  and  the  simulator  parameters  remain  unchanged. 


^Robert  Puttcamp,  SKYNET  Applications  Software  Package  (SASP) 
Programmers’  Handbook,  Version  2,  Harry  Diamond  Laboratories  TR~1844 
(February  1978) . 
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only  the  shot  number  entry  in  the  SYSCON.DAT  file  header  will  change.  A 
copy  of  the  current  SYSCON.DAT  file  becomes  an  entry  in  each  shot  file. 
The  shot  file,  Snnnnxx.DAT,  in  addition  to  the  system  configuration, 
contains  all  the  data  for  a given  shot.  The  data  include  the  baseline, 
calibration,  raw,  and  scaled  data  waveforms  for  each  digitizer  in  the 
system,  as  well  as  computed  parameters  and  user  or  operator  comments.  A 
complete  description  of  all  the  files  is  presented  in  the  following 
pages.  A knowledge  of  these  file  structures  is  basic  to  understanding 
the  operation  of  the  software  and  usage  of  the  data  base. 

Table  I defines  the  data  files  used  by  SASP.  The  shot  files  and  the 
MAIN.DAT  file  are  on  DKl : ; the  remaining  are  on  DKO:.  All  are  in  user 
file  directories  (UFD's)  with  a user  identification  code  (UIC)  of 
[100,100] . 


TABLE  I.  DATA  FILES 


Fi  le 

Data 

PRBCAL.DAT 

Probe  cal i brat i on 

ATNCAL.DAT 

Device  calibration 

XCHCAL.DAT 

Transmission  channel  calibration 

SYSCON.DAT 

System  configuration 

Snnnnxx. DAT 
(SH0T.DAT) 

Taken  for  simulator  shot  named 
with  four-digit  shot  number  nnnn 
and  two-character  simulator  code 

XX 

MAIN. DAT 

Preliminary  name  for  Snnnnxx.DAT 
fi  le 

Once  the  shot  number  and  simulator  code  locations  in  the 
SYSCON.DAT  file  have  been  set  (by  using  program  SHOTNO) , program  SYSCON 
points  to  the  name  of  the  current  shot  file.  This  name  is  composed  of 
the  letter  "S"  followed  by  the  four-digit  shot  number  and  the 
two-character  simulator  code  with  the  usual  extension  of  "DAT" . For 
excunple,  for  shot  No,  115  on  simulator  PI,  the  shot  file  name  is 
"S0115P1.DAT".  This  name  is  established  for  the  file  by  program  TABIN, 


12 


which  in  one  of  its  functions  renames  the  MAIN.DAT  file  to  the  shot  file 
name  pointed  to  by  the  SYSCON.DAT  file.  (The  term  "SHOT.DAT"  is  used  in 
this  handbook  as  a general  reference  to  a shot  data  file.) 

2 . 2 File  Structures 


In  the  following  pages,  the  structure  of  the  data  files  is  laid 
out  in  both  graphical  and  tabular  form  (tables  I to  IV,  fig.  2 to  4) . 
Wherever  possible,  space  has  been  left  for  future  expansion;  these  areas 
are  designated  as  "spare." 

Certain  entries  in  the  calibration  files  are  for  record  keeping 
only  and  are  not  used  by  SASP.  For  the  PRBCAL.DAT  file,  these  entfies 
are  the  following:  measurement  type,  model,  manufacturer's  serial 
number,  connector,  and  parameter;  for  the  ATNCAL.DAT  file;  model  and 
manufacturer's  serial  number;  and  for  the  XCHCAL.DAT  file;  fiber  number 
and  receiver  number.  If  delay  calculations  are  not  required,  delay 
entries  can  be  zero  in  the  calibration  files,  as  well  as  in  the 
SYSCON.DAT  file.  The  postreceiver  gain  value  in  each  channel  entry  in 
the  SYSCON.DAT  file  also  is  for  record  keeping.  The  manner  of 
calculating  the  data  link  gain  includes  the  data  link  gain  in  the  system 
gain  calculation  automatically  without  needing  an  additional  reference 
to  this  item. 

The  transmitters  and  channel  numbers  used  in  the  SYSCON.DAT 
file  are  defined  in  the  XCHCAL.DAT  file.  Though  the  SYSCON.DAT  file  may 
have  fewer  channels  defined  than  does  the  XCHCAL.DAT  file  (never  more) , 
its  first  channel  is  the  first  in  the  XCHCAL.DAT  file  and  so  on.  To 
change  transmitter  addresses,  the  SYSCON.DAT  file  must  be  changed  (by 
using  program  LOG) . Changing  digitizer  addresses  requires  regenerating 
the  SYSCON.DAT  file  by  using  program  CONGEN. 

The  XRD  bias  item  in  the  channel  entries  of  the  SYSCON.DAT  file 
is  a special  record-keeping  feature  to  be  activated  when  the  probe  used 
is  a biased  x-ray  detector  (XRD) . 

The  calibration  files  are  handled  by  subroutines  PRBREF, 
PRBSCH,  ATNREF,  ATNSCH,  XCHREF , XCHDRI,  and  XCHSCH.  The  SYSCON.DAT  file 
can  be  read  and  rewritten  by  the  sxibroutine  SCIO  (SCIN,  SCOUT  as  entry 
points) . Subroutine  FSCIN  is  used  to  read  the  SYSCON  information  from  a 
shot  file  into  common  block  SYSCON.  The  MAIN.DAT  and  shot  files  may  be 
accessed  from  FORTRAN  programs  through  the  subroutine  DATFIO,  The 
calibration  files  are  record  oriented,  while  the  SYSCON.DAT,  MAIN.DAT, 
and  shot  files  are  block  oriented. 
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TABLE  II.  CALIBRATION  FILE  ENTRIES 


Fi  le 

S i ze 
(bytes) 

1 tern 

Type' 

Offset 

(bytes) 

PRBCAL . DAT 

k 

Probe  identification  (four  characters) 

ASCII 

0 

entry 

k 

Transfer  function  (dB) 

FP 

4 

k 

Delay 

FP 

8 

8 

Un  i ts 

ASCII 

12 

2 

Flag  (such  as  integration  required) 

Integer 

20 

2 

Baiun  No. 

Integer 

22 

2 

Measurement  type 

ASCI  1 

24 

8 

Model 

ASCI  1 

28 

8 

Manufacturer's  serial  No. 

ASCI  1 

30 

8 

Connector 

ASCII 

44 

h 

Parameter  (such  as  equivalent  area) 

FP 

52 

5A  Total 

6I4  Provided  for 

ATNCAL.DAT 

k 

Device  identification 

ASCII 

0 

entry 

k 

Gain  (dB) 

FP 

4 

k 

Delay 

FP 

8 

8 

Model 

ASCI  1 

12 

8 

Manufacturer's  serial  No. 

ASCII 

20 

28  Total 

32  Provided  for 

XCHCAL.DAT 

2 

No.  of  channels 

Integer 

0 

header 

k 

At| 

FP 

4 

A 

trig) 

FP 

8 

i) 

Attrig2 

FP 

12 

4 

Atf i du 

FP 

16 

I) 

Atvert 

FP 

20 

k 

Baiun  No.  1 insertion  gain 

FP 

24 

k 

Baiun  No.  2 insertion  gain 

FP 

28 

k 

Baiun  No.  3 insertion  gain 

FP 

32 

3^  Total 

48  Provided  for 

XCHCAL.DAT 

2 

T ransmi tter  No. 

Integer 

0 

entry 

2 

Fiber  No. 

Integer 

2 

2 

Receiver  No. 

Integer 

4 

4 

Delay 

FP 

8 

4 

Calibration  pulse  reference  level 

FP 

12 

14  Total 

16  Provided  for 

^ASCIl;  American  Standard  Code  for  Information  Interchange;  FP:  floating  point. 
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TABLE  III.  SYSTEM  CONFIGURATION  (SYSCON.DAT)  FILE  ENTRIES 


Entry  Size 

(bytes) 

Item 

Type* 

Offset 

(bytes) 

Header  6 

Date 

3 integers 

0 

6 

Time 

3 integers 

6 

4 

Shot  nunber 

ASCII 

12 

2 

Shot  nimber 

Integer 

16 

2 

Niznber  of  digitizers 

Integer 

18 

2 

Nisober  of  digitizer  control  boards 

Integer 

20 

2 

Nisnber  of  channels 

Integer 

22 

2 

Virtual  block  nianber  (VPN) 

Integer 

24 

baseline  data 

2 

VBN  calibration  data 

Integer 

26 

2 

VBN  raw  data 

Integer 

28 

2 

VBN  scaled  data 

Integer 

30 

2 

VBN  parameters 

Integer 

32 

2 

VBN  user  cotments 

Integer 

34 

2 

Simulator  identification 

ASCII 

36 

2 

Wire  type  code 

ASCII 

38 

4 

Charging  voltage  output  level 

FP 

40 

4 

Tank  vacuum 

FP 

44 

4 

Voltage  diode  peak  value 

FP 

48 

4 

Current  diode  peak  value 

FP 

52 

30 

CoRncnt  (from  TABIN) 

AfCII 

56 

2 

NuKber  of  blocks  in  shot  file 

Integer 

86 

4 

Calorimeter  1 value 

FP 

88 

4 

Calorimeter  2 value 

FP 

94 

2 

NuiTber  of  samples  for  calorimeter  1 

Integer 

96 

2 

Number  of  samples,  calorimeter  2 

Integer 

98 

2 

Calorimeter  error  fl.ig 

Integer 

100 

2 

Filter  code 

Integer 

102 

4 

Calorimeter  1 uncertainty 

PP 

104 

4 

Calorimeter  2 uncertainty 

FP 

108 

4 

Filter  thic)u)ess 

FP 

112 

2 

Nupber  of  thicknesses  of  debris 

Integer 

116 

shield 

2 

Debris  shield  code 

Integer 

118 

40 

Spares 

120 

Diqitizer  block  2 

R7912  device  address 

Integer 

0 

2 

Channel  niziber 

Integer 

2 

2 

Error  flag 

Integer 

4 

2 

St«eep  rate 

Integer 

6 

2 

Vertical  sensor 

Integer 

8 

2 

Bloom 

Integer 

10 

2 

Baseline  offset 

Integer 

12 

4 

System  gain  in  decibels 

FP 

14 

4 

System  gain  factor 

FP 

18 

2 

Spare 

22 

(There 

are  20  of  these  blocks.) 

Channel  block  2 

Error  flag 

Integer 

0 

6 

Test  point 

FAD50 

2 

4 

Attenuator  identification 

ASCII 

8 

4 

Probe  identification 

ASCII 

12 

2 

XRO  bias 

Integer 

16 

2 

Transmitter  control  cable  nisnber 

Integer 

18 

2 

Pretransmittcr  cable  delay 

FP 

20 

4 

Device  identification 

ASCII 

24 

2 

Transmitter  number 

Integer 

28 

2 

Transmitter  attenuator  setting 

Integer 

30 

4 

Postreceiver  cable  delay 

FP 

32 

4 

Postreceiver  gain  value 

FP 

36 

2 

Nimber  of  digitizers  on  this 

Integer 

40 

channel 

2 

Nusiber  of  first  digitizer 

Integer 

42 

• 2 

Nissber  of  second  digitizer 

Integer 

44 

2 

Number  of  third  digitizer 

Integer 

46 

4 

Data  link  gain^ 

FP 

48 

4 

Data  link  scale  factor^ 

FP 

52 

4 

Channel  delay 

FP 

56 

4 

Spare 

60 

(There  are  27  of  these  blocks.) 

Calibration  4 Calibration  plus  or  minus  value  FP 

IHiititer  4 Calibration  sero  value  PP 

(These  t«ra  values  are  repeated 
for  each  diqitizer  in  the  system; 

192  bytes  are  available  for  this  information.) 


*ASCiI.'  American  Standard  Code  for  Informtion  mterchanqe. 

FP:  Floating  point  number. 

,RAD50:  Base  50  representation  of  ASCII  data. 

‘‘These  values  are  not  used;  the  real  information  is  stored  in  the  digitiser  array.  If  there 
is  more  than  one  digitiser  in  the  channel,  the  values  for  the  last  digitiser  are  stored  here. 
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TABLE  IV.  MAIN  DATA  (SHOT.DAT)  FILE  ENTRIES 


Entry 

S i ze 
(blocks) 

1 tern 

Type' 

Offset 

(bytes) 

Components 

5 

Copy  of  finalized  SYSCON 

2 per  TEK  R7912 

Basel i ne  data 

2 per  TEK  R79I2 

Cal ibrat ion  data 

8 per  TEK  R79I2 

Ravv  data 

it  per  TEK  R79t2 

Scaled  data 

I/i|  per  TEK  R791 

12 

Parameters 

1/8  per  TEK  R7912 

User  comments  (6it  charac- 

ters)  last  block  filled 

(bytes) 

Parameters 

2 

Evaluation  flag 

Integer 

0 

2 

Fiducial  time 

Integer 

2 

2 

Start  of  data  time 

Integer 

U 

2 

Time  of  peak  of  interest 

1 n tege r 

6 

2 

End  of  data  time 

Integer 

8 

2 

Time  of  peak  of  calibration 

1 nteger 

10 

i| 

Time  to  start  of  data  from 

FP 

12 

f idu 

it 

Peak  of  interest 

FP 

16 

it 

Time  to  peak  of  interest 

FP 

20 

from  data  start 

it 

Area 

FP 

2k 

2i| 

Comment  on  calibration  data 

ASCII 

28 

2it 

Comment  on  raw  data 

ASCI  1 

52 

2it 

Comment  on  scaled  data 

ASCII 

76 

100 

Total 

128 

Provided  for 

*FP;  Floating  point; 

ASCII:  American  Standard  Code  for  Information  Interchange 
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PRBCAL.DAT 


RECORD  NO.  1 

FIRST  PROBE  ENTRY 

32  WORD 

RECORD 

• 

• 

• 

LAST  PROBE  ENTRY 

32  WORD 

RECORD 

-rs 

32WORD 

RECORD 

ATNCAL.DAT 

RECORD  NO.  1 

FIRST  ENTRY 

16-WORD 

RECORD 

• 

• 

• 

LAST  ENTRY 

16WORD 

RECORD 

-VS 

76-WORD 

RECORD 

XCHCAL.DAT 

RECORD  NO.  1 

HEADER, PART  1 

8-WORD 

RECORD 

RECORD  NO.  2 

HEADER,  PART  II 

8-WORD 

RECORD 

RECORD  NO.  3 

HEADER,  PART  III 

8-WORD 

RECORD 

RECORD  NO.  4 

FIRST  CHANNEL  ENTRY 

8-WORD 

RECORD 

• 

• 

• 

RECORD  NO.  (3+m) 

LAST  CHANNEL  ENTRY 

8-WORD 

RECORD 

NOTE:  m IS  NUMBER  OF  CHANNELS  AS  DEFINED  IN  HEADER. 

Figure 

2.  Calibration  file  structures. 
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Figure  2.  Calibration  file  structures  (cont'd) 


PRBCAL.DAT  ENTRY 


PROBE  IDENTIFICATION 


ATNCAL.DAT  ENTRY 

3 0|  ATTENUATION  OR  BALUN/AMPLIF I ER 

IDENTIFICATION 


TRANSFER  FUNCTION 


DELAY 


MODEL 


MANUFACTURER'S  SERIAL  NO. 


MANUFACTURER'S  SERIAL  NO. 


XCHCAL.DAT  ENTRY 


CONNECTOR 


TRANSMITTER  NO. 


FIBER  NO. 


PARAMETER 


RECEIVER  NO. 


SPARE 


DELAY 


CALIBRATION  PULSE  REFERENCE  LEVEL 
63  12l |15 


NO.  OF 
CHANNELS 


XCHCAL.DAT  HEADER 


SPARE 


BALUN  NO.  1 INSERTION  GAIN  BALUN  NO.  2 INSERTION  GAIN 


BALUN  NO.  3 INSERTION  GAIN 


SPARE 


SPARE 


NOTE;  NUMBERS  OUTSIDE  OF  BOXES  ARE  BYTE  NUMBERS. 
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BLOCK  4 


CHANNEL  IS 
CHANNEL  16 
CHANNEL  17 
CHANNEL  18 
CHANNEL  19 
CHANNEL  20 
CHANNEL  21 
CHANNEL  22 


BLOCK  2 


LAST  » gyres  of  m is 

17  I 18  T T9'  I 20 

CHANNEL  1 
CHANNEL  2 
CHANNELS 
CHANNEL  4 
CHANNEL  S 
CHANNEL  6 


BLOCK  5 


CHANNEL  23 


CHANNEL  24 


CHANNEL  25 


CHANNEL  26 


CHANNEL  27 


CALieRATION  MARK 
IWfORMATlOW 


BLOCK  3 


CHANNEL  7 
CHANNEL  8 
CHANNELS 
CHANNEL  10 
CHANNEL  11 
CHANNEL  12 
CHANNEL  13 
CHANNEL  14 


Figure  3.  System  configuration  (SYSCON.DAT)  file  structure. 


19 


Figure  3.  System  configuration  (SYSCON.DAT)  file  structure  (cont'd) 


n K H7912  f NTRY 


CHANNEL  ENTRY 


TEK  R/912 
DEVICE 
ADDRESS 

channel  NO 

ERROR  FLAG 

SWEEP  RATE 

VERTICAL 

SENSOR 

BLOOM 

BASELINE 

POSITION 

SPARE 

ATTENUATION 

IDENTIFICATION 


PROBE  SENSOR 
IDENTIFICATION 


D BIAS  J 


THANSMITTtI 

ADDRESS 


PHE  TRANSMITTER 
CABLE  DELAY 


DEVICE  IDENTIFICATION 


TRANSMITTER 

NUMBER 


TRANSMITTER 

ATTENUATION 

SETTING 


POSTRECEIVER 
CABLE  DELAY 


POSTRECEIVER 
GAIN  VALUE 


TEK  R7912 
NO  1 NUMBE  R 


TEK  R7912  TEK  R791? 

m 2W^fB€R  r>/0  3lVVM8ffl 


DATA  LINK  GAIN 


SCALE  FACTOR 


OVERALL  DELAY  ( t , ,,  ,1 


3 


63 


NOTE  NUMBERS  OUTSIDE  OF  BOXES  ARE  BYTE  NUMBERS 
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COMPONENTS 


BLOCK  NO. 
BLOCK  NO. 

BLOCK  NO. 
BLOCK  NO. 


COPY 

OF  FINALIZED 

SYSCON 

RAW  DATA 

NO.  n 

SCALED  DATA 

NO.  1 

BASELINE  NO.  1 

• 

• 

• 

• 

• 

• 

BASELINE  NO.  n 

SCALED  DATA  NO.  n 

FIRST  BLOCK  OF 

CALIBRATION  NO.  1 

PARAMETER  ENTRIES 

• 

• 

• 

• 

• 

• 

LAST  BLOCK  OF 

PARAMETER  ENTRIES 

CALIBRATION  NO.  n 

FIRST  BLOCK  OF 

USER  COMMENTS 

• 

• 

RAW  DATA  NO.  1 

• 

LAST  BLOCK  OF 
USER  COMMENTS 


♦THERE  ARE  n TEK  R7912'S  KNOWN  TO 
THE  SYSTEM. 


Figure  4.  Shot  file  structure. 


Figure  4.  Shot  file  structure  (cont'd). 


PARAMETER  ENTRY 


0 


60 


EVALUATION 

FLAG 

FIDUCIAL  TIME 

START  OF 

TIME  OF  PEAK 

DATA  TIME 

OF  INTEREST 

END  OF 

TIME  OF  PEAK 

DATA  TIME 

OF  CALIBRATION 

TIME  TO  START  OF 
DATA  FROM  SIMULATOR 
PULSE  FIRING 


PEAK  OF  INTEREST 


TIME  TO  PEAK  OF  INTEREST 
FROM  DATA  START 


AREA 


COMMENT 

ON 

CALIBRATION 

DATA 


COMMENT 

ON 

RAW  DATA 


3 64 


63  124 


COMMENT  ON 
RAW  DATA 
(CONT'D) 


COMMENT 

ON 

SCALED  DATA 


SPARE 


67 


127 


3.  DATA  SYSTEM  OPERATIONS 
3,1  Introduction 

Prior  to  testing,  many  unknovm  quantities  remain  to  be  defined. 
The  data  system  calibration  files  must  be  generated;  information 
concerning  physical  test  varicibles  must  be  stored  in  memory.  Amplifier 
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gains,  calibration  pulse  reference  levels,  and  sensor  and  probe 
identification  numbers  must  be  made  known  to  the  data  system. 
Section  3,2  defines  the  procedures  for  constructing  calibration  files, 
the  files  that  contain  the  information  necessary  to  conduct  a test. 
Separate  programs  exist  for  modifying  each  of  these  calibration  files. 
Log  forms  to  be  filled  out  by  the  STARS  operator  and  the  experimenter 
also  are  described.  The  information  on  these  logs  provides  the  needed 
cross  references  between  calibration  and  data  files. 

Next,  terminal  input  conventions  are  .presented.  This 
information  is  of  use  to  the  STARS  console  operator  for  the  input  of 
tabular  data  from  the  log  forms. 

A description  of  the  data-taking  sec[uence  follows  in 
section  3.4.  The  SASP  software  can  be  run  in  the  manual  or  automatic 
mode.  That  is,  the  separate,  modular  programs  can  be  combined  into  an 
indirect  command  file  and  run  automatically.  The  SASP  software  was 
specifically  designed  to  run  in  this  mode,  under  the  control  of  TESTSEQ. 
Section  3,4.1  explains  the  features  of  TESTSEQ  and  the  procedures  for 
abnormally  aborting  TESTSEQ.  Precautions  to  be  observed  for  running  the 
SASP  programs  in  the  manual  mode  also  are  given.  Discussion  on 
disc-to-tape  transfer  conventions  and  the  method  for  preparing  new  discs 
conclude  this  section. 

3,2  Data  System  Generation 

The  calibration  and  configuration  files,  XCHCAL.DAT, 
ATNCAL.DAT,  PRBCAL.DAT,  and  SYSCON.DAT,  must  be  established  before  data 
taking  can  occur.  Devices  and  attenuators  to  be  used  should  be  entered 
in  the  ATNCAL.DAT  file  by  using  progrcim  ATN.  Probes  are  specified  in 
the  PRBCAL.DAT  file  with  program  PRB. 

The  contents  of  the  XCHCAL.DAT  file  must  be  established  before 
generating  th«  SYSCON.DAT  file;  otherwise,  the  transmitter  numbers  are 
not  available  when  needed.  Program  XCH  provides  for  the  generation  of 
the  XCHCAL.DAT  file.  Then  program  CONGEN  may  be  used  to  establish  the 
SYSCON.DAT  file. 

Before  beginning  data  system  generation,  the  alignment  of 
transmitters,  channels,  and  digitizers  should  be  decided.  Creating  the 
XCHCAL.DAT  file  provides  the  association  between  the  channel  number  and 
the  transmitter  numbers.  After  the  SYSCON.DAT  fils  is  created,  program 
LOG  is  run,  and  the  selected  channel  numbers  are  input  into  the 
digitizer  log.  These  actions  complete  the  link. 

To  change  a digitizer  address,  the  SYSCON.DAT  file  is 
regenerated.  To  modify  a transmitter  address,  program  LOG  must  be  run. 
The  SASP  data  input  requirements  follow. 
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The  generalized  SASP  data  channel  can  be  visualized  as  shown  in 
figure  5.  Each  item  has  a gain  or  delay  or  both  associated  with  it, 
Gains  are  given  in  decibels  calculated  from  equations  of  this  form: 


Attenuator  gain  (dB)  = 20  log^^Q 


output  (selected  units) 
input  (same  units) 


Probe  gain  (dB)  = 20  log 


output  (volts) 

10  input  (selected  units) 


r 


Device  gain  (dB)  = 20  log^^ 


output  (volts) 
input  (volts) 


The  gain  of  the  transmission  channel  ("data  link  gain")  is  calculated 
from  a knowledge  of  the  calibration  pulse  reference  level  and  a 
measurement  of  the  peak  recorded  at  the  digitizer.  The  gain  is 
calculated  in  program  CHKCAL  (sect.  4.2.2).  All  the  gains  are  combined 
into  a single  overall  scale  factor  by  program  SCALE.  There,  the  overall 
delay  also  is  calculated. 

The  Tektronix  R7912's  have  many  characteristics.  They  receive 
their  own  entry  in  the  configuration  file  (SYSCON.DAT)  which  is  linked 
to  the  channel  entry  by  the  channel  number.  Three  digitizers  may  be  so 
linked  to  a single  channel.  (See  the  SASP  file  structures,  sect.  2.2.) 

The  attenuator,  probe,  device,  and  transmission  channel  also 
receive  special  treatment.  Calibration  files  are  established  to  define 
their  characteristic  gains  and  delays  and  to  perform  other  bookkeeping 
functions.  The  input  required  is  as  follows; 

Device  or  attenuator  (ATNCAL.DAT  file,  program  ATN) 

Identification  (four  characters) 

Gain  (decibels) 

Delay  (nanoseconds) 

Model  (eight  characters) 

Manufacturer's  serial  number  (eight  characters) 

Probe  (PRBCAL.DAT  file,  task  PRB) 

Identification  (four  characters) 

Transfer  function  (gain  in  decibels) 

Delay  (nanoseconds) 

Data  processing  flag 
1 = integration 
0 = simple  scaling 
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TRANSMISSION 

CHANNEL 


Figure  5.  Generalized  data  channel. 


j 
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Baiun  number  (transmitter  input) 

1 = 100  ohms  differential 

2 = 50  ohms  single  ended 

3 = 78  ohms  differential 

Scaled  data  units  (eight  characters)  (selected  units) 
Measurement  type  (two  characters) 

Parameter  (such  as  equivalent  area  for  B-dot  probe) 

Model  (eight  characters) 

Manufacturer's  serial  number  (eight  characters) 

Connector  (eight  characters) 

Transmission  channel  (XCHCAL.DAT  file,  program  XCH) 

Transmitter  number  (integer) 

Fiber  number  (integer) 

Receiver  number  (integer) 

Delay  (nanoseconds) 

Calibration  pulse  reference  level  (millivolts) 

Each  transmission  channel  entry  in  the  XCHCAL.DAT  file  is  assigned  a 
channel  number,  which  serves  as  its  identification  and  which  is  forced 
to  be  the  same  number  as  that  of  the  data  channel  that  includes  it. 

There  are  also  certain  system-wide  constants  required  for  gain 
and  delay  calculations.  These  are  placed  in  the  header  section  of  the 
XCHCAL.DAT  file  by  program  XCH.  The  delay  constants  are  illustrated  in 
figure  6 and  are  given  in  nanoseconds.  The  gain  values  are  the  inser- 
tion loss  of  each  of  the  three  Isaluns  built  into  the  transmitters.  The 
negative  absolute  value  of  the  number  input  is  stored. 

The  overall  channel  delay,  is  calculated  in  program 

SCALE.  The  time  delay  of  the  oscilloscope  time  base,  At^^  , drops  out  of 
any  equations  presently  in  use.  All  other  At's  illustrated  in  figure  6 
cire  input  for  program  XCH. 

The  experimenter  is  given  several  pertinent  delay  times  on  the 
tabular  output  illustrated  in  section  4.3.  The  following  definitions 
will  prove  useful  in  interpreting  the  delay  time  factors  in  these 
tables ; 


DTI  |Atj^ 


measured  time  from  source  to  trigger  sensor 
(x-ray  sensor) 
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TRIGGER  TRIGGER 
SIMULATOR  PROBE  GENERATOR 
FIRES  RESPONDS  RESPONDS 


BEGIN 

TRIGGER  TARGET 


At 


trig  , 


At, 


FIDUCIAL  TO 
PLUG-IN 


FIDUCIAL 


At 


f idu 


At 


vert 


DATA 

SENSOR 

RESPONDS 


AtTp 


At 


data 


DATA  TO  START 
PLUG-IN  DATA 


■TIME 


TIME 


PEAK  OF 
INTEREST 

1 TIME 


DATA 

PROBE/SENSOR 


Figure  6.  Delay  considerations. 


DTRIG2  (At^  . + 

' trigj 

At  . 
trig2) 


trigger  sensor  delay  from  trigger  sensor  to 
fiber  optic  transmitter,  fiber  optic  trigger  link 
delay,  delay  time  through  trigger  generator,  and 
delay  in  all  cables  from  output  of  trigger  genera- 
tor to  external  trigger  input  on  Tektronix  R7912 
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DTFIDU 


delay  time  though  fiducial  generator  and  all 
cables  up  to  Tektronix  R7912  vertical  amplifier 
input 


DIVERT  /At  \ delay  of  digitizer  vertical  channel  (7A19 
' amplifier) 

The  delay  entry  DELAY  in  the  quick-look  system  configuration 
dump  table  is  in  figure  6.  The  entry  CHANNEL  DELAY  in  the  final 
system  configuration  table  also  corresponds  to  At^jj^^a  shovm  in  figure  6. 
Figure  2 and  tables  II  to  IV  illustrate  in  which  files  several  of  the 
delay  constants  shown  in  figure  6 are  stored. 

The  SYSCON.DAT  file  contains  three  sections:  (1)  channel 
entries,  (2)  digitizer  entries,  and  (3)  certain  other  information  in  a 
header  section.  The  file  is  created  with  task  CONGEN,  which  expects  the 
following  input: 


Number  of  digitizers  (<20) 

Number  of  digitizer  controller  boards  (<4) 

Number  of  channels  (<  number  in  XCHCAL.DAT  file) 

UNIBUS  address  for  each  digitizer  in  the  form  I6XODO0,  where 

O 

X = 3 + controller  card  number 

D = unit  number  (0  to  7)  ■v.. 

Combined  with  the  transmitter  addresses  found  in  the  XCHCAL.DAT  file, 
this  information  begins  the  SYSCON.DAT  file.  To  it  is  added  information 
describing  the  content  of  each  channel,  the  desired  settings  of  each 
digitizer,  and  the  interconnections  between  the  channel  and  the 
corresponding  digitizer  entry.  (This  connection  must  be  established 
before  the  new  SYSCON.DAT  file  is  used.) 

Four  input  log  forms  are  necessary  to  fulfill  the  entry 
requirements  of  the  SYSCON.DAT  file.  The  information  is  entered  with 
program  LOG,  which  has  four  "pages"  of  input  that  correspond  to  the 
format  of  the  logs.  The  standard  SASP  terminal  input  conventions  apply. 

Figures  7 to  10  are  saunple  logs.  The  cunonents  column  on  the 
transmitter  log  (fig,  8)  is  for  user  comments  to  be  entered  at  a 
different  time  into  a different  file.  The  exact  nature  of  the  entries 
is  as  follows: 
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Probe  log  (fig.  7) 

TEST  PT:  test  point  name,  nine  alphanumeric  characters 

maximum  for  specifying  probe  location,  test  conditions,  and  other 
characteristics 

ATTN  ID:  identification  of  attenuator  entered  in  ATNCAL.DAT 

file  ("blank"  mean;  no  attenuator) 

SENSOR  ID:  identification  of  probe  entered  in  PRBCAL.DAT 

file 


PRE  XMTR  CABLE  DELAY:  value  to  reflect  delays  not  accounted 
for  by  other  pretransmitter  entries 

DEVICE  ID:  identification  of  device  entered  in  ATNCAL.DAT 

file  ("blank"  means  no  device) 


SHOT  NO. 


PROBE  LOG 


(next  expected) 


CHANNEL 

TEST 

PT 

ATTN 

ID 

SENSOR 

ID 

PRE  XMTR 
CABLE  DELAY 

DEVICE 

ID 

1 

2 

3 

20 

Figure  7.  Probe  log. 

Transmitter  log  (fig.  8) 

TRANSMITTER  ATTN:  transmitter  attenuation,  0 to  45  dB  in 

3-dB  steps  (negative  absolute  value  of  input  is  stored) 
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XRD  BIAS ! special  case , integer  parameter  to  be  used  in 
specifying  variable  probes,  particularly  biased  XRD's 

TRANSMITTER  ADDRESS:  control  cable  number  from  EG&G 

attenuator  controller  box 

COMMENTS  (LAST  SHOT) : user  comments 


TRANSMITTER  LOG 


Figure  8.  Transmitter  log. 


Receiver  log  (fig.  9) 


digitizer 


DELAY  (REC-DIG) : value  reflecting  delay  between  receiver  emd 


ATTN  (REC-DIG) t value  recording  attenuation  between  receiver 
cuid  digitizer  (not  used  in  calculations,  since  measuring  data  link  gain 
automatically  includes  it) 
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RECEIVER  LOG 


DATE 

START  SHOT  END  SHOT 


CHANNEL 

DELAY 

(REC-DIG) 

ATTN 

(REC-DIG) 

1 

2 

3 

20 

Figure  9.  Receiver  log. 


Digitizer  log  (fig.  10) 

DIG.  NO.  (OPER)  : operator's  alignment  of  channels  cind 

digitizers;  program  LOG  prints  digitizer  number  and  requests  channel 
number 


SWEEP  (NS/DIV) ! sweep  rate  in  nanoseconds/division 

VERT  SENS  (MV/DIV) : vertical  sensitivity  in  millivolts/ 

division 

BASELINE  OFFSET  ( ± MINOR  DIV) : must  be  zero — this  feature 
is  not  currently  implemented 

CHANNEL  NO. ; channel  to  which  this  digitizer  is  connected 

Simulator  information  is  entered  into  the  header  area  of  the 
SYSCON.DAT  file  in  two  stages.  Program  SHOTNO  requests  and  stores  a 
one-to  four-digit  shot  number  and  a two-character  simulator  code,  which 
should  be  "02"  for  the  Oil  Water  Line  II,  SGEMP  Simulator  (OWL  II).  The 
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DIGITIZER  LOG 


DIG. 

NO. 

(OPER) 

SWEEP 

(NS/DIV) 

VERT 
SENS 
(mV/DI V) 

BASELINE 

OFFSET 

(±  MINOR  DIV) 

CHANNEL 

NO. 

1 

Figure  10.  Digitizer  log. 


second  stage  takes  place  with  program  TABIN,  which  has  two  modes  of 
input,  a special  one  (for  02)  and  a general  one. 

Special  (02)  mode 

Wire  type  (two  characters) 

Pulse  charge  (megavolt) 

Tank  vacuum  (torr) 

Voltage  diode  peak  (volt) 

Current  diode  peak  (volt) 

Comment  (30  characters) 

Debris  shield  code  (integer) 

Number  of  debris  shield  thicknesses  (integer) 

Filter  code  (integer) 

Filter  thickness  (floating  point) 

General  mode 

Configuration  code  (two  characters) 

Output  level  (units  not  yet  established) 

Comment  (30  characters) 

Space  in  the  shot  file  has  been  provided  for  user  comments. 
They  are  logged  on  the  transmitter  log  for  the  shot  to  follow.  The 
program  used  to  enter  them  is  USRCOM.  It  expects  64  or  fewer 
characters. 

In  all  terminal  entries,  except  the  digitizer  UNIBUS  address  in 
input  to  the  CONGEN  file,  standard  SASP  terminal  input  conventions 
apply. 
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3.3 


Terminal  Input  Conventions 


A line  of  input  is  read  in  by  subroutine  INPUT.  This  line 
consists  of  fields  (or  columns)  separated  by  the  control  I or  TAB 
character.  The  first  field  begins  with  the  first  character.  Each 
subsequent  control  I begins  a new  field,  irrespective  of  preprinted 
column  headings. 

The  three  forms  of  input  conversion — American  Standard  Code  for 
Information  Interchange  (ASCII),  integer,  and  floating  point — are 
performed  by  subroutines  ASDCD,  FXDCD,  and  FLDCD,  respectively.  The 
choice  of  field  is  made  by  a field-number  param.eter.  See  the  individual 
documentation  for  each  subroutine. ^ The  DEC  terminal  input  line  editing 
commands,  control  U and  RUBOUT,  are  still  operative. 

For  a given  field,  there  are  three  null  conditions: 

a.  The  input  was  terminated  (carriage  return)  before  the  field 
was  reached. 

b.  The  field  was  reached,  but  a second  control  I was  given 
immediately. 

c.  The  first  character  of  the  field  was  a blank. 

Under  conditions  a and  b,  the  value  stored  before  input  remains 
untouched.  Condition  c causes  a zero  to  be  stored. 

3.4  Data-Taking  Sequence 

3.4.1  TESTSEQ  Operations  Control  File 

The  SASP  data-taking  sequence  is  controlled  by  indirect 
command  file  DK1:[ 100, 100]  TESTSEQ.CMD.  (For  general  information  on 
indirect  command  files,  see  the  Operator's  Procedures  Manual  for  DEC 
RSX-llM.^)  Decisions  by  the  operator  are  entered  by  means  of  yes  (Y)  or 
no  (N)  answers  to  preprogrammed  questions.  Operations  are  carried  out 
by  programs  executing  on  comn.and  from  TESTSEQ.  Many  programs  require 
operator  input  or  provide  output.  Pauses  in  command  file  processing  are 
placed  at  crucial  points;  the  system  is  then  under  the  direct  control  of 
the  operator. 


^Robert  Puttcamp,  SKYNET  Applications  Software  Package  (SASP) 
Programmers'  Handbook,  Version  2,  Harry  Diamond  Laboratories  TR-1844 
(February  1978). 

^Operator's  Procedures  Manual  RSX-llM  Version  2,  DEC-ll-OMOGA-B-D , 
Digital  Equipment  Corp, , Maynard,  MA  (September  1975). 
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If  abnormal  conditions  require  exiting  from  TESTSEQ's 
control,  typing  control  C and  a carriage  return  "punches  through"  to  the 
operating  system.  If  TESTSEQ  has  paused,  is  waiting  for  an  answer  to  a 
question,  or  is  printing  comments,  the  operator  types  "ABO  AT.  (CR) " . 
If  a SASP  program  is  running,  the  operator  should  type  "ABO  AT.  (CR) " 
and  "ABO"  plus  first  three  characters  of  the  program  name.  This  will 
abort  both  the  running  program  and  the  indirect  command  file  processor. 
If  only  the  command  "ABO  AT."  is  entered,  the  indirect  command  file 
processor  will  be  aborted  at  the  termination  of  the  running  program.  If 
the  aborted  program  referenced  a data  file,  the  file  may  be  locked.  As 
soon  as  possible,  the  operator  should  use  the  DEC  utility 
PIP  (Peripheral  Interchange  Program)  to  unlock  the  file. 

Any  task  that  references  the  digitizers  or  the  transmitters 
may  produce  error  messages  at  the  terminal.  The  standard  SASP  digitizer 
and  channel  error  codes  apply  (see  app  A for  details) . 

Before  the  data-taking  sequence  can  begin,  a few  operations 
must  be  performed  or  confirmed.  The  RSX-llM  operating  system  must  be 
running  from  a suitable  system  disc:  one  that  has  all  the  needed  DEC 
utility  tasks  and  SASP  data  files.  A data  disc  with  sufficient  storage 
space  must  be  mounted;  if  it  is  not,  the  operator  makes  room  or 
initializes  a new  one.  The  correct  time  and  date  should  be  entered  with 
the  monitor  console  routine  (MCR)  command  TIME.  The  indirect  command 
file  DATAOP.DAT  should  be  processed,  either  as  a direct  MCR  command  or 
by  use  of  TESTSEQ. 

Shot  files  are  to  be  transferred  to  magnetic  tape  as  quickly  as 
possible.  Also,  at  some  established  interval  (such  as  once  a day),  the 
master  data  tapes  should  be  updated. 

Figure  11  is  the  flowchart  for  TESTSEQ.  Errors  during  task 
BASE  should  be  resolved  before  TESTSEQ  continues.  Besides  acquiring 
baselines,  this  task  is  meant  to  act  as  a screen  for  all  potential 
problems  at  other,  more  crucial  steps  in  the  process.  The  TESTSEQ 
Operations  Control  File  (app  C)  can  be  used  as  an  aid  to  understanding 
the  flowchart.  Individual  task  documentation  in  the  SASP  Programmer's 
Handbook,'^  as  well  as  the  source  listings,  also  will  prove  helpful. 


^Robert  Puttcamp,  SKYNET  Applications  Software  Package  (SASP) 
Programmers’  Handbook,  Version  2,  Harry  Diamond  Laboratories  TR-1844 
(February  1978). 
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Figure  11.  Flowchart  for  TESTSEQ. 
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Figure  11.  Flowchart  for  TESTSEQ  (cont'd) 
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Figure  11.  Flowchart  for  TESTSEQ  (cont'd) 
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TRIGGER 


Figure  11. 


Flowchart  for  TESTSEQ 


(cont'd) . 
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Figure  11.  Flowchart  for  TESTSEQ  (cont'd). 


RAWCPY 


GRAPH  RAW  DATA,  lIMPUT 
COMMENT,  MAKE  COPY 


MARK 


EVALUATE  NORMALIZED 
DATA 


TABIN 


INPUT  SIMULATOR  INFORMATION 
AND  RENAME  MAIN.DAT  FILE 


SCACPY 


GRAPH  AND  COPY  SCALED 
DATA 


tables 


PRINT  TABLES 


SUMERR 


PRINT  ERROR  FLAGS 


I DIRECT  OPERATOR  TO 
INPUT  USER 
COMMENTS, 
TRANSFER  SHOT 
FILE  TO  MAGNETIC 
TAPE 


^ STOP  ^ 
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Figure  11.  Flowchart  for  TESTSEQ  (cont'd). 


EXPANSION  OF 


RESET  FLAGS* 


> 
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3.4.2  Manual  Data  Acquisition  Procedures 

Care  must  be  taken  when  TESTSEQ  is  abandoned  and  data-taking 
instructions  are  entered  manually.  The  operator  should  be  very  familiar 
with  the  processes.  He  should  never  run  program  SCALE  without  running 
task  CHKCAL  to  screen  out  bad  (incorrect)  data  link  gains.  The  operator 
sets  the  shot  number  with  program  SHOTNO  before  producing  any  output. 
He  runs  program  TABIN  to  renaime  the  MAIN.DAT  file  before  running  program 
OUTFIL  to  create  the  next  MAIN.DAT  file.  The  operator  should  always  run 
program  PREDAT  before  DATAPC  and  be  sure  that  the  error  flags  represent 
a desired  and  proper  status. 

3.4.3  Disc  Preparation 

The  following  summarizes  the  instructions  for  preparing  a new 
data  disc  ("volid"  means  volume  identification) : 

DM0  DK2:volid 

(Remove  old  data  disc;  put  new  one  in  place.) 

BAD  DK2 : 

INI  DK2  :volid/BAD=  [AUTO] 

MOU  DK2:volid 

UFD  DK2:[100,100] 

If  the  new  disc  has  actually  been  previously  used,  the  contents  will  be 
lost.  If  the  disc  is  brand  new,  it  will  have  to  be  formatted  first  by 
using  the  stand-alone  utility  PRESRV. 


4 . DATA  PROCESSING 

4.1  Normalization 

The  raw  data  acquired  through  digitizing  a waveform  with  the 
digitizer  are  not  in  a form  compatible  for  processing  by  a digital 
computer.  Usually,  there  is  an  overabundance  of  data  describing  the 
waveform.  Sometimes,  there  is  a lack  of  data  describing  certain 
portions  of  the  waveform.  Ideally,  there  are  two  vertical  values  for 
each  horizontal  value.  These  vertical  values  correspond  to  the  upper 
and  lower  edges  of  the  path  traced  by  an  electron  beam  as  it  sweeps 
across  the  target.  Here,  a simple  average  can  determine  the  true  center 
of  the  trace  to  a resolution  of  1 part  in  512.  For  more  or  less  than 
two  vertical  values,  an  algorithm  is  required  to  determine  the  most 
likely  center  of  the  trace  for  that  particular  point  on  the  raw  data 
waveform.  It  is  the  task  of  the  normalization  routines  to  process  the 
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raw  data,  with  their  excesses  and  deficiencies,  and  to  obtain  from  them 
a more  usable  presentation  of  the  waveform. 

There  are  six  basic  steps  to  the  normalization; 

a.  Average  to  the  center  of  the  trace  (ATC) . 

b.  Eliminate  noise  points. 

c.  Fill  gaps  by  linear  interpolation. 

d.  Fill  end  gaps  with  zeros. 

e.  Subtract  the  baseline  trace. 

f.  Subtract  256. 

For  baseline  traces  and  calibration  traces,  these  steps  are  carried  out 
with  integer  arithmetic.  Data-trace  normalization  uses  floating  point 
operations.  Step  e is  not  used  for  baseline  traces;  in  step  d,  a 
baseline  trace  is  extrapolated  rather  than  filled  with  zeros. 

a.  The  ATC  reduces  the  raw  digitizer  data  to,  at  most,  a 
single  vertical  value  for  each  horizontal  value.  The  original  raw  data 
are  composed  of  horizontal  and  vertical  values  in  a one-dimensional 
array.  The  vertical  values  that  are  associated  with  a horizontal  value 
follow  it.  Each  such  group  is  in  order  by  horizontal  value,  except  that 
the  data  start  at  an  arbitrary  horizontal  position  of  the  target  and 
wrap  to  the  starting  point.  Horizontal  values  are  differentiated  from 
vertical  ones  by  having  the  bit  in  variable  HZMSK  set  (app  D) . ("HZMSK" 
is  defined  as  lOOOg  by  the  SYMDEF  macro,  a macro  used  to  initialize  all 
SASP  parameters.  See  app  D.)  Points  flagged  with  the  bit  in  variable 
BADBIT  are  excluded  from  consideration.  ("BABBIT"  is  defined  as  lOOOOg 
by  the  SYMDEF  macro.)  If  a horizontal  value  is  flagged  as  bad,  it  is 
assumed  that  the  associated  vertical  values  also  are  bad.  Vertical 
values  are  recorded  from  the  top  of  the  target  to  the  bottom. 

Once  a vertical  value  is  masked  with  variable  DTAMSK,  its 
value  is  the  vertical  position  on  the  target  and  is  in  the  range  of  0 to 

511.  When  a horizontal  value  is  masked,  the  result  is  the  complement  of 

the  position  on  the  target.  The  complement  also  is  in  the  range  of  0 to 
511.  The  coordinates  (0,0)  correspond  to  the  lower  left-hand  corner. 
Each  horizontal-vertical  group  is  resolved  into  a horizontal  value  with 
a single  vertical  value. 

The  ATC  routines  consider  four  groups:  (1)  a single 

vertical  value,  (2)  two  vertical  values,  (3)  three  vertical  values,  and 
(4)  four  or  more  vertical  values.  Each  group  is  considered 

independently . 
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Group  1 . — It  is  assumed  that  the  bottom  edge  of  the  trace 
was  missed  due  to  the  dead  time  of  the  read  gun;  the  dead  time  is 
equivalent  to  the  time  for  the  scan  gun  to  read  four  points.  The  single 
vertical  value  is  then  shifted  down  slightly  by  subtracting  two. 

Group  2. — The  separation  of  the  two  vertical  values  is 
compared  to  variable  BLMFAC  times  the  bloom  parameter.  If  the 
separation  is  less  than  this  product,  the  two  are  averaged.  If  not,  the 
separation  is  flagged  as  a gap  point. 

Group  3. — The  closest  pair  is  chosen,  and  the  conditions  of 
group  2 are  applied. 

Group  4. — Four  or  more  vertical  values  are  immediately 
flagged  as  a gap  point.  The  flag  for  a gap  point  is  "-1."  All 
well-defined  vertical  values  are  from  0 to  511. 

Since  the  bloom  parameter  used  in  groups  2 and  3 is 
calculated  from  the  baseline  trace  (see  documentation  for  subroutine 
BASATC  in  the  Prograimmers ' Handbook^) , the  baseline  ATC  requires  a 
simplified  approach.  Group  1 remains  the  same.  For  group  2,  the 
averaging  takes  place  automatically.  Groups  3 and  4 result  in  gap 
points. 


b.  The  trace  is  now  a single  dimensional  array  of  512  vertical 
values  and  gap  points  with  the  horizontal  value  being  implied  by  the 
subscript  of  a particular  vertical  value.  This  array  is  now  scanned  for 
points  where  the  slope  between  two  vertical  values  is  greater  than 
variable  TANMAX  in  absolute  value.  The  value  of  TANMAX  is  to  be  chosen 
so  that  it  represents  the  writing  rate  limit  of  the  digitizer.  For  any 
pair  found  to  have  a slope  greater  than  TANMAX,  the  second  value  of  the 
pair  becomes  a gap  point.  It  does  so  if  the  first  value  of  the  pair  is 
valid  and  the  trace  could  not  actually  move  from  there  to  the  second 
point. 


c.  Steps  a and  b have  probably  produced  at  least  a few  gap 
points.  These  are  filled  by  linearly  interpolating  between  the  vertical 
values  that  remain. 

d.  The  gap  points  at  either  end  cannot  be  interpolated. 
Except  for  the  baseline,  extrapolation  does  not  seem  suitable.  The  gaps 
at  the  ends  of  the  calibration  and  data  traces  are  set  so  that  they  are 


^Robert  Puttcamp,  SKYNET  Applications  Software  Package  (SASP) 
Programmers’  Handbook,  Version  2,  Harry  Diamond  Laboratories  TR-1844 
(February  1978). 
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zero  after  steps  e and  f.  The  baseline  is  extended  by  averaging  the 
five  valid  vertical  values  at  the  end  and  using  that  average  for  the  gap 
points  at  that  end. 

e.  The  baseline  trace  is  subtracted,  point  for  point,  from  the 
calibration  trace  and  the  data  trace. 

f.  The  value  256  is  subtracted  from  each  vertical  value  to 
place  zero  at  the  center  line. 

The  following  subroutines  are  used : 


Step 

Subroutine 

Type  of  Trace 

a 

BASATC 

CALATC 

DATATC 

Baseline 

Calibration 

Data 

b 

ELIMPT 

QKELIM 

Data 

Baseline , 

calibration 

c 

INTRP 

QKLNTP 

Data 

Baseline, 

calibration 

d,e,f 

EXTRAP 

ISBASE 

SUBASE 

Baseline 

Calibration 

Data 

4 , 2 Data  Evaluation  and  Characterization 

During  the  data-taking  sequence,  four  types  of  data  are 
available  for  evaluation:  baseline,  calibration,  raw,  and  normalized. 
The  programs  used  to  plot  these  data  are  CHKBAS,  CHKCAL,  RAWCPY,  and 
MARK,  respectively.  The  STARS  operator  is  responsible  for  reviewing  the 
data  for  quality  and  completeness.  He  is  not  typically  an  experimenter 
eind,  therefore,  cannot  be  expected  to  judge  the  data  in  the  context  of 
the  experiment.  Instead,  he  should  comment  on  data  deficiencies  or 
excesses  relatable  to  hardware  misuses,  limitations,  or  malfunctions. 

Data  are  characterized  in  task  MARK  (sect.  4.2.4).  There,  key 
parameters  of  interest  to  the  experimenter  are  marked  with  the  graphic 
cursor  by  the  STARS  operator. 
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4,2.1  Baseline  Data 


Prior  to  an  actual  experiment  (simulator  shot) , baseline  data 
must  be  acquired  from  each  digitizer  so  that  the  proper  intensity 
setting  for  each  digitizer  may  be  determined.  Through  use  of  the  TV 
monitor,  the  baseline  may  be  observed  while  the  position  and  intensity 
are  adjusted.  Then  program  BASE  is  run  to  digitize,  acquire,  normalize, 
and  store  the  baseline  data  on  a disc . If  any  intensity  settings  were 
incorrect,  an  appropriate  error  message  appears  on  the  terminal. 

Typical  error  messages  are  "BLM,"  bloom  too  large  or  too 
small,  and  "SHF,"  baseline  trace  position  not  as  requested.  "BLM" 
indicates  that  the  intensity  setting  for  that  digitizer  was  either  too 
high  or  too  low.  This  setting  can  be  corrected  by  adjusting  the 
intensity  and  rerunning  program  BASE,  "SHF"  is  usually  caused  by  an 
incorrect  baseline  position.  Repositioning  the  baseline  and  rerunning 
program  BASE  corrects  this  error.  (App  A lists  and  discusses  error 
codes , ) 


Baseline  data  are  used  primarily  for  two  purposes:  (1)  The 
baseline  waveform  is  subtracted  from  the  calibration  and  experiment  data 
waveforms  to  reform  any  nonuniformities,  such  as  baseline  tilt. 
(2)  Monitoring  the  baseline  is  a quick  method  of  determining  if  the 
digitizers  are  functioning  properly  and  the  desired  knob  settings  are 
correct.  The  turnaround  time  for  program  BASE  is  typically  less  than 
2 min. 


If  several  attempts  at  acquiring  a baseline  on  one  or  more 
digitizers  do  not  produce  the  desired  result,  two  separate  programs  are 
available  as  diagnostics.  Program  CHKBAS  can  be  used  to  graph  the 
baselines  on  the  console  display,  and  program  BLMCHK  can  be  used  to 
print  the  bloom  parameter  for  each  digitizer  on  the  operator's  console. 
Once  error  flags  are  noted,  they  must  be  reset  by  running  program  CLEAR 
before  new  baselines  can  be  acquired  from  the  suspect  digitizers.  If  a 
digitizer  or  channel  error  flag  is  not  reset,  no  data  from  that 
digitizer  or  channel  are  processed  or  output  in  any  subsequent  routine 
in  the  current  production  run.  If  only  one  or  a few  baselines  need  to 
be  rerun,  the  other  digitizers  can  be  flagged  out  by  running  program 
FLAG  and  disabling  them.  Program  CLEAR  must  be  run  after  program  BASE 
to  re-enable  these  digitizers. 

4.2.2  Calibration  Data 


A calibration  waveform  is  obtained  from  each  optical  trans- 
mitter calibration  generator.  The  calibration  pulse  amplitude  as 
recorded  at  the  digitizer  is  a measure  of  the  optical  data  link  gain. 
In  program  CHKCAL,  calibration  waveforms  for  each  channel  eure  plotted  on 
the  R4010  terminal.  The  peak  positive  or  negative  value  of  the 
calibration  pulse  is  marked  by  the  operator  using  the  graphic  cursor  on 
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the  R4010  terminal.  Then  the  zero  value  of  the  calibration  pulse  is 
marked.  The  data  link  gain  is  calculated  and  stored  in  disc  file 
MAIN.DAT. 

4.2.3  Raw  Data 


Programs  DATAPC,  CONDAT,  and  MORDAT  are  used  to  acquire  the 
raw  data  from  the  digitizers  and  store  the  data  on  a disc.  Raw  data  are 
the  multivalued  functions  read  directly  from  the  digitizer  target 
(fig.  12) . Although  they  are  not  useful  for  mathematical  machine 
computations  in  this  format,  the  raw  data  are  very  useful  to  the 
experimenter  for  a quick  look  and  to  the  terminal  operator  in 
determining  if  the  digitizer  writing  rate  has  been  exceeded.  Program 
RAWCPY  plots  the  raw  data  for  each  digitizer  and  permits  entry  of  an 
operator  comment  prior  to  producing  a hard  copy.  These  raw  data  are 
made  available  to  the  experimenter  within  minutes  after  the  shot.  At 
this  stage  in  data  evaluation,  an  experienced  operator  can  predict  the 
success  of  the  normalization  in  upcoming  programs. 

50  MU  20  NS 


COMMENT  = 


Figure  12.  Raw  data,  Scunple  1. 
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4,2,4  Normalized  Data 


During  data  taking,  the  first  opportunity  to  view  the 
normalized  data  occurs  in  program  MARK,  With  the  normalized,  unsealed 
data  graphed  on  the  terminal,  the  operator  evaluates  and  marks  the  data 
waveforms  (fig,  13) , First,  a preprogrammed  message  is  printed 
instructing  the  operator  to  sequence  the  graphic  cursor  to  three  points 
of  interest  on  the  data  plot.  The  time  values  of  these  points  are  then 
transferred  to  the  main  data  file  on  the  disc.  (Because  the  data  are 
stored  as  amplitudes  in  a 512-element  array  comprising  equal  time 
intervals,  knowing  the  time  or  array  index  is  sufficient  for  determining 
the  corresponding  amplitude,)  Lastly,  the  prompt  appears  for  a comment 
to  be  entered.  Comments  may  be  up  to  24  characters  long. 


50  MU/DIU  5 NS/C'IU 


FIDU  PEAK,  STfrd  AMD  PEftK-O.'^-INTEREST. STRIKE  ANY  CHARACTER 
l'!A!i!<  TIMES  OKCY/fOTY 
ENTER  ATTN  REO.UIREDC  -3)08:0 

com:  ;eht  = 

Figure  13.  Normalized  data. 

The  waveforms  graphed  in  program  MARK  reflect  raw  data  that 
have  undergone  the  entire  normalization  process.  At  this  stage,  hard 
copies  of  the  raw  data  have  already  been  printed  and  can  be  directly 
compared  one  to  one  with  their  normalized  counterparts  in  program  MARK. 
Copies  of  the  unsealed,  normalized  data  cire  not  generally  retained; 
however,  they  could  be  reproduced  later. 
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4.3  Typical  Production  Run 


On  each  shot,  the  experimenter  is  provided  with  a system 
configuration  printout  (fig.  14) , which  gives  the  date  and  time  of  the 
event,  a synopsis  of  equipment  used  on  the  event,  and  the  output  of  the 
two  calorimeters  associated  with  the  STARS. 
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Figure  14.  System  configuration  printout. 


Within  5 min  after  the  event,  the  experimenter  is  given  a copy 
of  the  raw  data  for  each  digitizer  (fig.  12,  15).  He  can  quickly 
estimate  the  magnitude  by  dividing  the  number  of  digitizer  volts  by  the 
"factor"  given  in  figure  14,  The  raw  data  are  annotated  with  the  shot 
number  and  the  digitizer  pareuneters. 
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OIGITIZEf?  NO.  1 RAW 
SHOT  HO. = 295? 

COHHEHT : 


Figure  15.  Raw  data,  sample  2. 


Within  45  min,  the  experimenter  is  given  a copy  of  the  scaled 
data  (fig.  16)  in  the  units  desired  by  him.  Accurate  timing  between 
channels  is  possible  by  referencing  the  marker  pulse  (fiducial)  at  the 
left  edge  of  all  data  traces.  The  STARS  operator  marks  each  trace  with 
the  location  of  the  fiducial  marker,  the  start  time  of  the  data,  and  the 
time  of  the  peak  of  interest.  Vertical  timing  tick  marks  indicate  the 
exact  locations  of  these  parameters  on  the  scaled  data  plot.  Annotation 
of  several  key  parameters,  such  as  the  coded  test  point  name,  also  is 
provided  for  each  plot. 

Special  output  routines  permit  printing  of  the  raw  data,  the 
calorimeter  szunple  values,  the  baseline  data,  etc.  Routines  have  been 
created  also  to  allow  for  printing  the  contents  of  each  of  the 
calibration  files;  for  example,  figure  17  was  generated  by  program  PRB. 
Program  PRB  lists  all  the  probes  currently  in  the  PRBCAL.DAT  file  and 
pertinent  parameters  for  each  probe. 


50 


0.100E  10MPS  /DI0  20  HS/DIU 


PEft:<=  -27 . 31i3E-Gl  AilF'S 
TIKE  TO  PEAK=  17.1S7E  00K'S 
CALORIKETER  TP3^  1 . 3e202E-05CAUCK:v:;V2 
CftLOPiKETER  2S=  2 .02174E-8^CAL/CK;;:;::2 

Figure  16,  Scaled  data. 
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Figure  17.  Probe  file  listing. 


COMNECTOR 
2 sm  50 
2 SMft  50 
2 Stift  50 
2 sm  50 
2 sm  50 
I sm  50 
1 sm  50 

1 sm  50 

2 sm  50 

2 SI';.'I  5£< 

1 sm  50 
1 sm  50 
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4.4  Storage  and  Retrieval 


Storage  requirements  can  be  estimated  by  using  the  format  of 
the  shot  file  given  in  section  2.2  and  the  following  file  entry 
information : 


Type  of  data 


Storage 

(256-word  blocks) 


Copy  of  SVSCON.DAT  file  5 
Baseline  data  2 
Calibration  data  2 
Raw  data  8 
Scaled  data  4 
Parameter  entry  k 
User  comment  entry 


For  example,  if  15  digitizers  were  being  used,  the  file  size  or 
disc  space  requirements  would  be  as  follows: 


5 + 2n  + 2n  + 8n  + 4n  + n/4  + n/4  = 5 + 16. 5n 
=5+16.5  X 15 
= 252.5  blocks  . 

This  must  be  rounded  up  to  a whole  block  value;  hence  the  file 
would  actually  use  253  disc  blocks. 

Further,  assume  that  10  simulator  shots  (10  SH0T.DAT  files)  are 
to  be  recorded:  10  x 253  = 2530  blocks.  The  disc  pack  used  to  store 
these  data  contains  1,228,800  words.  Therefore,  a disc  pack  contains 
4800  blocks.  For  a typical  test  period  of  several  weeks,  some  other 
form  of  off-line  storage  is  indicated.  The  STARS  uses  nine-track  tape 
compatible  with  that  used  in  industry. 

At  the  end  of  each  day's  testing,  the  data  disc  contents  are 
transferred  to  a magnetic  tape.  This  tape  then  becomes  the  master  data 
tape.  This  master  data  tape  is  then  copied  to  provide  a backup.  A test 
progrcim  typically  lasts  from  2 to  3 weeks.  The  data  from  this  program 
should  fit  on  a single  reel  of  tape.  Backup  copies  of  all  master  data 
file  tapes  are  retained.  These  tapes  then  comprise  the  STARS  data  bank. 

Certain  features  have  been  incorporated  into  the  shot  file 
structure  to  facilitate  searching.  In  the  SYSCON  header  entry  of  the 
shot  file  (fig.  3) , virtual  block  number  (VBN)  entries  point  to  the 
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first  entry  of  each  type  shown.  For  example,  on  shot  No.  2937  for 
digitizer  No.  1,  the  sequence  for  obtaining  the  raw  data  would  be  as 
follows : 

a.  The  operator  locates  the  master  file  tape  containing  shot 
No.  2937  and  mounts  this  tape  on  the  nine-track  tape  unit. 

b.  The  operator  uses  the  appropriate  program  to  search  for  the 
proper  file.  For  example,  the  shot  file  may  be  "S293702.DAT."  The  "02" 
is  the  simulator  code  for  the  OWL  II  simulator.  The  "S"  and  the  "DAT" 
are  always  the  same. 

c.  The  operator  transfers  the  data  to  the  disc. 

d.  The  SYSCON  header  in  the  S293702.DAT  file  contains  an  entry 
entitled  "VBN,  RAW"  which  is  an  integer  representing  the  block  number 
within  the  S293702.DAT  file  of  the  raw  data  of  digitizer  No.  1.  Reading 
forward  eight  blocks  transfers  the  data  of  interest.  (Raw  data  are 
always  eight  blocks  in  length.) 

Another  example  is  the  test  point  name  contained  in  the  SYSCON 
channel  entry  of  the  shot  file.  The  test  point  name  permits  nine  ASCII 
characters  that  can  be  coded  into  representing  some  important  parameters 
of  the  test.  For  example,  three  digits  can  be  used  to  code  1000 
different  location  or  test  point  descriptions,  two  digits  can  denote  the 
measurement  type,  and  two  digits  can  denote  the  simulator  orientation 
and  type.  This  type  of  coding  facilitates  search  algorithms. 


5.  BRIEF  MODULE  DESCRIPTIONS 

This  section  presents  a short  synopsis  of  each  program  and 
subroutine  in  SASP.  Detailed  descriptions  of  each  module  can  be  found 
in  the  SASP  Programmers'  Handbook.^  Indirect  command  file  TESTSEQ  is 
discussed  in  section  3.4.1.  Wherever  possible,  the  subroutines  and 
macros  have  been  grouped  logically  into  object  and  macro  libraries 
resident  on  the  SASP  disc  (app  E) . 

Indirect 

command  file  Function 

TESTSEQ  Control  data  acquisition  and  processing  program 

execution. 


Task  Fxinction 

ATN  Generate,  modify,  and  print  contents  of  ATNCAL.DAT  file. 

^Robert  Puttcamp,  SKYNET  Applications  Software  Package  (SASP) 
Prograimers'  Handbook,  Version  2,  Harry  Diamond  Laboratories  TR-1844 
(February  1978) . 
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Task 


Function 


BASE 

BLKCNT 

BLMCHK 

CAL 

CHKBAS 

CHKCAL 

CLEAR 

CONDAT 

CONGEN 

DATAPC , 
CONDAT , 
MORDAT 

ERASE 

FIXNPT 

FLAG 

FPLOT 

GETCON 

KNOB 

LOG 


Acquire,  normalize,  and  store  baseline  for  each  enabled 
digitizer. 

Print  number  of  blocks  required  for  shot  file  (that  is, 
MAIN.DAT  and  Snnnnxx.DAT) . 

List  digitizer  entries  in  SYSCON  COMMON  area  in  core  on 
operator's  console. 

Acquire,  normalize,  and  store  calibration  trace  for  each 
enabled  digitizer. 

Plot  baseline  data. 

Plot  and  evaluate  calibration  waveforms,  compute  optical 
link  gain,  and  input  comments. 

Reset  digitizer  and  channel  flags  to  values  stored  in 
disc  file  FLAG.DAT. 

(See  DATAPC.)  . 

Generate  SYSCON. DAT  file  and  initialize  digitizer 

addresses. 

Acquire  and  store  raw  data  trace  for  each  enabled 
digitizer;  acquire,  analyze,  and  print  calorimeter  data; 
these  programs  are  always  run  as  chain. 

Erase  screen  of  terminal  or  give  eight  line  feeds  on  LA36 
DEC  Teletype  terminal. 

Allow  partial  recovery  from  overflow  condition  on  data 
trace;  fix  data  point  count  of  raw  data  at  2000;  on  over- 
flow, store  first  2000  points  read. 

List  digitizer  and  channel  error  flag  and  allow  enabling 
or  disabling. 

Plot  final  scaled  data  produced  by  program  VCOPY 
Read  file  SYSCON.DAT  into  COMMON  area  SYSCON. 

Switch  all  enabled  digitizers  to  knob  setting  mode  (TV 
and  graticule) . 

Input  log  information  to  SYSCON.DAT  file. 
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Task 


Function 


MARK 

MORDAT 

OFFLIN 

OUTFIL 

PLOTC 

PLTCLR 

PRB 

PREDAT 

PRTNAM 

RAWCPY 

RECCAL 

SAVCON 

SCACPY 

SCALE 

SCAVP 

SETFLG 

SHOTNO 

SNAP IT 

SUMERR 


Plot  and  characterize  normalized  data  waveforms  and  input 
comments . 

(See  DATAPC.) 

Test  each  enabled  digitizer  for  off-line  condition. 

Create  MAIN, DAT  file. 

Dummy  FORTRAN  program  to  call  PLTCLR  to  get  around  some 
system  problems  with  DEC  FORTRAN. 

Plot  calorimeter  data  on  R4010  terminal  and  make  hard 
copy  of  them. 

Generate,  modify,  and  print  contents  of  PRBCAL.DAT. 

Prepare  enabled  digitizers  for  data  taking  (required 
precursor  for  DATAPC,  CONDAT,  and  MORDAT) . 

Print  name  of  shot  file  to  which  SYSCON  COMMON  area 
points. 

Plot,  annotate,  and  comment  on  raw  data  waveforms. 

Reproduce  calibration  traces  and  operator's  marks  on 
R4010  terminal  and  make  hard  copy  of  plots. 

Write  file  SYSCON.DAT  from  COMMON  area  SYSCON. 

Plot,  annotate,  and  rescale  data  waveforms  using  R4010 
terminal  and  hard-copy  device. 

Normalize  and  scale  raw  data  traces,  calculate  overall 
scale  factor  and  data  link  gain,  emd  store  results. 

Plot,  annotate,  and  rescale  data  waveforms  using  Versatec 
plot  package  cind  MlllO  printer  plotter. 

Generate  master  flag  setting  file  FLAG.DAT. 

Input  simulator  code  and  shot  number  to  SYSCON  COMMON 
area. 

Dump  SYSCON  common  peurtition  to  line  printer  in  standard 
RSX-llM  format. 

Print  digitizer  emd  channel  error  flags. 
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Function 


Task 

SYSCHK 

SYSDMP 

TABIN 

TABLES 

USRCOM 

VCOPY 

XCH 

Subroutine 

ABSPKV 

ANOCLR 

ANOMRK 

ANOSCA 

ANOT8 

ANSWER 

ASCBIN 

ASDCD 

ASTSC 

ATNREF 

ATNSCH 

ATTEN 

BASATC 

BUSY 


Check  validity  of  certain  entries  in  SYSCON  COMMON  area. 

Quickly  dump  contents  of  SYSCON  COMMON  area. 

Input  simulator  information  to  SYSCON.DAT  file,  and 
rename  MAIN.DAT  file  to  current  shot  file  name. 

Generate  three  tables  of  user-oriented  tabular  output 
data. 

Input  user  comments  to  shot  file. 

Generate  disc  file  containing  final  scaled  data  graphs. 
Generate,  modify,  and  print  contents  of  XCHCAL.DAT  file. 

Function 

Compute  absolute  peak  value  of  ATC  array. 

Annotate  plots  of  calorimeter  data. 

Annotate  MARK  (unsealed,  normalized  data). 

Annotate  parameters  on  scaled  data. 

Annotate  Versatec  plot  package  final  data  graphs. 

Input  and  decode  "yes"  or  "no"  answer  from  console. 

Convert  ASCII  input  to  binary  integers. 

Transfer  selected  ASCII  field  from  input  buffer. 

Set  and  clear  asynchronous  system  trap  (AST)  for  RAWPLT 
program;  recognize  ESC  key  on  TTl:. 

Handle  reference  to  ATNCAL.DAT  file. 

Read  ATNCAL.DAT  file  for  entry  of  selected  device. 

Set  and  verify  remote  attenuator  settings,  produce 
baseline,  and  calibrate  triggers. 

Perform  ATC  for  baseline  trace,  including  bloom  calcu- 
lation. 

Wait  for  clearing  of  busy  status  of  digitizer. 
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Function 


Subroutine 

CALATC 

CALCSF 

CALIB 

CALOR 

CALPLT 

CALSPC 

(CALIB) 

CHACNT 

CHKTRG 

CHNERR 

CLRCBD 

CMDDIG 

DATATC 

DATFIO 

DCDBIT 

DIGEFB 

DISABL 

DSKERR 

ELIMPT 

ERRNUM 

EXTRAP 

FIELD 


Perform  ATC  for  calibration  trace. 

Calculate  overall  scale  factor  and  data  link  gain. 

Control  transmitters  during  acquisition  of  calibration 
trace. 

Process  data  from  calorimeters. 

Actually  plot  calorimeter  data  on  R4010  terminal. 

Control  transmitters  during  acquisition  of  calibration 
trace,  but  do  not  flag  out  either  digitizers  or  channels 
for  errors. 

Count  number  of  nonblank  ASCII  characters  in  integer 
array. 

Check  each  enabled  digitizer  for  trigger  interrupt. 

Flag  channel  errors. 

Clear  digitizer  controller  boards'  status  words,  thereby 
disabling  interrupts. 

Send  selected  command  to  all  enabled  digitizers  and  con- 
firm its  execution. 

Perform  ATC  for  data  trace. 

Handle  input  and  output  to  MAIN.DAT  and  shot  files. 

Generate  table  of  codes  corresponding  to  bits  set  in 
given  word. 

Flag  digitizer  errors. 

Set  disabled  flag  in  digitizer  or  channel  error  word. 

(AST  routine)  Handle  disc  errors. 

Eliminate  noise  points  frcm  data  trace  of  ATC. 

Return  bit  number  of  left-most  bit  set  in  given  word. 

Extrapolate  ends  of  baseline  trace,  and  subtract  256  from 
entire  baseline  trace. 

Set  pointer  to  selected  field  in  input  buffer,  and  count 
characters  in  field. 
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Subroutine 


Function 


FLDCD 

FLGPTS 

FLOTE 

FLPOP 

FSCIN 

FXDCD 

GETBAS 

GETCAL 

GETDAT 

GRAATC 

GRABAS 

GRACAL 

GRAPHV 

GRARAW 

GRASCA 

GRAT 

lASCII 

IFICKS 

INITLZ 

INPCSR 

INPUT 


Decode  floating  point  number  from  selected  field  in  input 
buffer . 

Flag  raw  data  points  known  to  be  incorrect. 

Convert  integer  to  floating  point  number. 

(Multientry  point  subroutine)  Handle  floating  point 
arithemetic. 

Read  copy  of  SYSCON  from  shot  file  into  SYSCON  COMMON. 

Decode  integer  from  selected  field  in  input  buffer. 

Read,  reduce,  and  store  baseline  trace  for  all  enabled 
digitizers. 

Read,  reduce,  and  store  calibration  trace  for  all  enabled 
digitizers. 

Read  and  store  raw  data  trace  for  all  enabled  digitizers. 
Graph  normalized  floating  point  data. 

Graph  baseline  data. 

Graph  calibration  data. 

Plot  scaled  data  for  final  data  plots  from  Versatec  plot 
package. 

Plot  raw  data. 

Plot  scaled  data. 

Plot  graticules  on  terminal  in  three  sizes. 

Convert  integer  of  less  than  five  digits  to  ASCII. 

Convert  floating  point  number  to  integer  (truncate) . 

Read  and  store  data  from  calorimeters. 

Input  data  characterization  parameters  with  graphic 
cursor. 

Input  line  from  logical  unit  number  (LUN)  5 to  input 
buffer. 
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Subroutine 


Function 


INT 

INTABL 

INTDIG 

INTRP 

ISBASE 

LSTERR 

MARKIT 

MINMAX 

MRKCUR 

N SCALE 

PAGE 

PLTSF 

PRBREF 

PRBSCH 

PRICLR 

QKELIM 

QKLNTP 

RAWPLT 

RDIG 

RDUKRO 


Integrate  scaled  data  by  trapezoidal  integration  method. 
Enable  digitizer  interrupts. 

Handle  digitizer  interrupts. 

Fill  gaps  in  data  trace  by  linear  interpolation. 

Subtract  baseline  trace  and  256  from  calibration  trace. 
List  channel  or  digitizer  errors. 

Put  cursor  marks  generated  by  program  MARK  on  final  data 
graphs  for  Versatec  plot  package. 

Search  integer  array  for  minimum  and  maximum  values. 

Print  cursor  marks  generated  by  subroutine  INPCSR  on 
scaled  and  unsealed  data  plots. 

Adjust  floating  point  number  to  value  between  1 and  10, 
and  calculate  proper  exponent  of  10  to  keep  same  value. 

Erase  screen  at  terminal  or  give  eight  line  feeds  on  LA36 
Teletype  terminal. 

Annotate  digitizer  scale  factors  on  baseline, 
calibration,  ATC  (normalized) , or  raw  data  plots. 

Handle  references  to  PRBCAL.DAT  file. 

Read  PRBCAL.DAT  file  for  entry  of  selected  probe. 

Print  raw  calorimeter  data. 

Eliminate  noise  points  from  ATC  of  baseline  or  ATC  of 
calibration  trace. 

Fill  gaps  in  baseline  or  calibration  trace  by  linear 
interpolation . 

Condition  raw  data  array  for  plotting  by  subroutine 
GRARAW. 

Read  raw  data  from  digitizer. 

Reduce  knob  readout  information  in  raw  data  and  compare 
it  with  desired  settings. 
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Subroutine 


Function 


SAVCLP 

SCADAT 
SCGEN 
SC  10 

SCMAIN 

SETVEC 

STCDAT 

SUBASE 

UCOUT 

VGRAT 

XCHDRI 

XCHREF 

XCHSCH 

XMIT 

XMTSPC 

.RSTR 

.SAVE 

Macro 

RDSECT 

SCSECT 

SYMDEF 


Write  calorimeter  data  into  file  on  DKl:  having  same 
name  as  shot  file,  but  starting  with  C instead  of  S. 

Normalize  and  scale  raw  data  traces,  and  store  results. 

Create  SYSCON.DAT  file,  and  write  initial  information. 

Read  and  rewrite  SYSCON.DAT  file  into  and  from.  SYSCON 
COMMON  area  in  core. 

Copy  SYSCON.DAT  file  into  MAIN.DAT  file,  and  rename 
MAIN.DAT  file  to  current  shot  file  name. 

Initialize  digitizer  interrupt  vectors. 

Transfer  trigger  date  and  time  from  TIME  variable  to 
SYSCON  COMMON  area  in  core. 

Subtract  baseline  trace  and  256  from  data  trace. 

Write  user  comments  into  shot  file. 

Produce  graph  frame,  cross  bars,  and  tick  marks  for 
graphs  produced  with  Versatec  package. 

Read  header  records  of  XCHCAL.DAT  file. 

Handle  references  to  XCHCAL.DAT  file. 

Read  XCHCAL.DAT  for  entry  of  selected  channel. 

Control  transmitters  during  acquisition  of  data  trace. 

Control  transmitters  during  acquisition  of  data  trace; 
report,  but  do  not  flag  out,  attenuator  verification 
errors. 

Restore  registers  from  stack. 

Save  registers  on  stack. 

Function 

Establish  PSECT  (program  section)  for  RAWDAT  COMMON  area 
Establish  PSECT  for  SYSCON  COMMON  area. 

Define  commonly  used  symbols. 
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ABBREVIATIONS 


ASCII  American  Standard  Code  for  Information  Interchange 

ATC  Average  to  center  of  trace 

CR  Carriage  return 

CRO:  Card  reader  unit  No.  0 

CTO:  Cassette  tape  unit  No,  0 

CTl ; Cassette  tape  unit  No.  1 

DEC  Digital  Equipment  Corp. 

DKO:  Disc  unit  No.  0,  system  disc 

DKl:  Disc  unit  No.  1 

LA36  DEC  Teletype  terminal  (TTl : ) 

LPO;  Versatec  MlllO  line  printer,  unit  No.  0 

LUN  Logical  unit  number 

NCR  Monitor  console  routine 

MTO:  Magnetic  tape  unit  No.  0 

MlllO  Printer  plotter 

OWL  II  Oil  Water  Line  II,  SGEMP  simulator 

RKll  DEC  type  number  for  disc  drives  on  PDP  11/40 

RSX-llM  DEC  operating  system 

R632  Tektronix  television  monitor 

R4010  Tektronix  main  console  graphic  display  terminal  (TTO: ) 

R7912  Tektronix  transient  digitizer,  primary  data  recording 

device 

SASP  SKYNET  Applications  Software  Package 
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ABBREVIATIONS  (Cont'd) 


SGEMP 

Systems  generated  electromagnetic  pulse 

STARS 

SGEMP  Transportable  Automated  Recording 

System 

SY: 

System  disc,  usually  DKOi 

Tl! 

Operator's  current  console,  either  TTO: 

or  TTl 

TV 

Television 

UFD 

User  file  directory 

UIC 

User  identification  code 

VBN 

Virtual  block  number 

XRD 

X-ray  detector 
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APPENDIX  A. — DIGITIZER  AND  CHANNEL  ERROR  CODES 


A-1. 

SUMMARY 

Both  the  digitizer  and 
contain  integer  words  for  error 
shown  below. 

channel  entries  in  the  SYSCON.DAT  file 
flags,  each  bit  of  which  is  coded  as 

Digitizer  Error  Words 

Bit 

No. 

Octal 

equivalent 

Code 

Meaning 

0 

000001 

OFF 

Off  line 

1 

000002 

DIS 

Disabled 

2 

000004 

OVF 

Data  overflow 

3 

000010 

UNF 

Data  underflow 

4 

000020 

BZY 

Busy  status 

5 

000040 

CMD 

Command  execution  error 

6 

000100 

TRG 

Failure  to  trigger 

7 

000200 

VFY 

Reading  verification  error 

8 

000400 

KRO 

Bad  (incorrect)  Icnob  readout 

9 

001000 

BLM 

Bloom  too  large  or  too  small 

10 

002000 

SHF 

Baseline  trace  position  not  as 
requested 

11 

004000 

(Unassigned) 

12 

010000 

(Unassigned) 

13 

020000 

NOB 

No  baseline  trace 

14 

040000 

NOC 

No  calibration  trace 

15 

100000 

NOD 

No  raw  data  trace 
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Channel 

Error  Words 

Bit 

Octal 

No. 

equivalent 

Code 

Meaning 

0 

000001 

OFF 

Offline 

1 

000002 

DIS 

Disablement 

2 

000004 

ATN 

Attenuator  setting  verification 
error 

3 

000010 

CAL 

Bad  calibration  trace 

4 to  5 (Unassigned) 


A-2.  CAUSES  AND  RECOVERY 

Following  is  a list  of  the  digitizer  and  channel  error  codes, 
the  conditions  which  cause  the  error  to  be  generated,  and  the  procedure 
to  correct  the  faulty  condition. 


Digitizer 


error  code 

Cause 

Recovery 

0000 

1. 

Digitizer  is  off  or 
physically  disconnected. 

1. 

Turn  on  or  reconnect 
digitizer. 

0001 

1. 

Digitizer  is  inten- 
tionally disabled 
(with  program  FLAG) . 

1. 

Reenable  digitizer  with 
program  FLAG. 

2. 

Error  is  on  asso- 
ciated channel. 

2. 

Reenable  digitizer  with 
program  FLAG. 

0002 

1. 

Too  many  points  are 
stored  in  digitizer 
memory , 

1. 

Decrease  intensity  or 
increase  sweep  rate 
(faster  sweep  speed) . 

0003 

1. 

Too  few  points  are 
stored  in  digitizer 
memory. 

1. 

Ascertain  proper  trigger 
available,  increase 
intensity,  or  both. 

0004 

1. 

Busy  status  exists. 

1. 

Allow  digitizer  to  warm 

up.  Manually  switch  to 
digital  and  back  to  non- 
store on  digitizer  front 
panel. 
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Digitizer 
error  code 

Cause 

Recovery 

0005 

1. 

Command  is  not 

1. 

Check  digitizer  front 

executed. 

panel  and  plug-in 
switches  for  nonstore, 

2. 

Digitizer  is  not  in 

single  sweep,  and  exter 

proper  status  (such 
as  single  shot  mode) . 

nal  trigger. 

0006 

1. 

Trigger  cable  is 
disconnected. 

1. 

Reconnect  cable . 

0007 


0008 


0009 

0010 


2.  Trigger  level  and 
slope  are  improper. 

1.  On  variable  TRYMAX  sepa- 
rate attempts , second 
reading  of  digitizer 
memory  had  more  than 
variable  MISMAX  words 
different  from  first 
reading . 

1,  Setting  of  plug-in 
does  not  match  that 
requested. 

2 . American  Standard 
Code  for  Information 
Interchange  (ASCII) 
readout  is  incorrect. 


1.  Intensity  is  too  high 
or  too  low. 

1.  Baseline  position  is 
incorrect. 

2.  Noise  rides  on  base- 
line. 

3.  Noise  point  in  digitizer 
is  not  eliminated  by 
normalization . 


2.  Readjust  level  and 
slope . 

1.  Repair  digitizer  after 
repeated  errors 


1.  Change  request  in 

SYSCON.DAT  file  with 
program  LOG  or  change 
plug-in  setting. 

2.  Repair  ASCII  board. 

Temporarily  reenable  it 
and  continue  as  though 
no  error  occurred. 
Ascertain  that  plug-ins 
are  set  as  desired. 

1.  Adjust  intensity  and 
rerun  program  BASE. 

1.  Reposition  baseline. 


2.  Check  input  signal. 


3.  Rerun  program  BASE. 
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Digitizer 

error  code  Cause 


Recovery 


0013 


0014 


1.  There  was  a previous 
error. 


1.  If  previous  error 
occurred  before  acqui- 
sition and  reduction  of 
baseline  trace,  there 
is  truly  no  baseline; 
therefore,  rerun  pro- 
gram BASE  after  correc- 
ting error. 

2.  If  previous  error  was 
0008,  0009,  or  0010, 
baseline  data  are 
stored  and  can  be 
checked.  Correct  error 
and  rerun  program  BASE. 


1. 


There  was  a previous 
error  during  program  CAL. 


1.  Follow  directions  for 
error  0013,  using  task 
CAL. 


0015  1.  There  was  a previous 

error  during  program 
MORDAT. 


1.  Follow  directions  for 
error  0013,  using  pro- 
gram MORDAT. 


Channel 
error  code 


Cause 


Recovery 


0000 


1.  Transmitter  is  not 
connected. 


1.  Connect  transmitter. 


0001  1.  Channel  was  inten-  1.  Reenable  channel, 

tionally  disabled. 

2.  Associated  digitizer 
had  error. 


0002 


0003 


1.  Transmitter  attenuator 

did  not  respond  properly. 


1.  Operator  considered 
calibration  trace  to 
be  wrong. 


1.  Manually  override 
attenuator.. 

2 . Repair  attenuator . 

1.  Obtain  good  calibra- 
tion trace  with  program 
CAL,  and  recheck  trace 
with  program  CHKCAL. 
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A-3 . GENERAL 

An  error  condition  automatically  prevents  the  unit  and  its 
associated  data  from  being  accessed  further.  All  programs  examine  the 
error  word.  Before  any  form  of  recovery  is  attempted  or  data  are 
accessed,  the  operator  should  use  program  CLEAR  to  reenable  the  unit. 

If  he  desires  to  eliminate  a digitizer  from  consideration,  the 
operator  should  use  program  FLAG  to  disable  the  digitizer,  thereby 
creating  error  condition  0001.  To  permanently  disable  a digitizer,  use 
program  SETFLG. 

An  error  condition  generates  a disable  error  (0001)  also  on  the 
associated  units.  The  exception  occurs  when  only  one  of  the  digitizers 
connected  to  a channel  is  in  error.  Under  this  condition,  the  channel 
is  not  disabled. 
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A fairly  comprehensive  description  of  programming  for  the  Tektronix 
R7912  transient  digitizer  can  be  found  in  the  appropriate  Tektronix 
manual;^  only  the  basics  are  described  here. 

These  Digital  Equipment  Corp.  (DEC)  UNIBUS^  addresses  are  used  in 
programming : 

16X000g  Digitizer  controller  status  word  for  card  No.  (X-3) 

16xOD2g  Digitizer  command  register  for  digitizer  defined  as 
having  address  16X0D0- 

O 

16X0D4g  Digitizer  data  and  status  register  for  digitizer 
defined  as  having  address  16X0D0 

O 

The  controller  status  word  content  is  defined  as  follows: 

Bit  Definition 

0 Interrupt  pending 

3,4,5  Device  number  ("D”  of  address)  of  interrupting  device 
6 Interrupt  enable 

The  digitizer  status  word  content  is  defined  as  follows: 

Bit  Definition 

0 Identity  as  R7912  digitizer 

1 Remote  channel  mode 

2 Memory  locked  (write  protect) 

3 Graticule  enabled 

4 Single  sweep  armed 

5 Single  sweep  mode 

^ WDI  TEK  BASIC  Software  User ' s Manual , Tektronix , Inc . , 
Beaverton,  OR  (1974), 

^DEC  POP  11  Processor  Handbook,  1975-1976 , Digital  Equipment  Corp., 
Maynard,  MA  (1975). 


fiSPEfiZMO  PA(iB  VZ 


I 

^ . 
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Bit 

Definition 

6 

Channel  1 selected  (if  in  remote) 

7 

Digital  mode 

8 to  12 

(Not  used) 

13 

Busy 

The 

"clear," 

following  are  the  digitizer  commands 
and  "X=l"  equates  to  "enable": 

where  "X=0"  equates  to 

Command 

Function 

12000g 

Load  memory,  repetitive  sweep  only. 

20X2g 

Inhibit  knob  readout  output. 

20X3g 

Select  channel  No.  1. 

20X4g 

Select  dot  graticule. 

20X5g 

Select  digital  mode. 

20X6g 

Select  remote  channel  mode. 

20X7g 

Lock  memory. 

2020g 

Read  status  (status  placed  in  status 

register) . 

2040g 

Arm  single  sweep. 

2100g 

Read  data  (data  word  placed  in  data 
moved  out) . 

register  as  previous  word 

4000g 

Initialize  registers. 

For  direct  diagnostic  control,  to  enter  commands  at  the  front  panel 
switches  of  the  central  processing  unit,  the  operator  deposits  the  front 
peinel  switch  contents  to  the  command  register  address.  To  read  the 
status,  the  operator  examines  the  status  register.  The  DEC  PDP  11/40 
Processor  Handbook 2 describes  the  console  operation.  With  the  memory 
management  option  in  place,  the  direct  addresses  are  76X0D0g  instead  of 
16X0D0  although  the  virtual  address  for  privileged  tasks  remains  as 
lexODOg. 

^DEC  PDP  11  Processor  Hcindbook,  1975-1976,  Digital  Equipment  Corp, , 
Maynard,  MA  (1975) . 


.1 

1 
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More  complete  diagnostic  capabilities  exist  in  the  Waveform 
Digitizing  Instrument  (WDI)  TEK  BASIC  operating  system  loadable  from  a 
cassette  or  disc.  Both  the  cassette  and  the  disc  are  availcible  at  the 
Systems  Generated  Electromagnetic  Pulse  Transportable  Automated 
Recording  System  (STARS)  facility  to  aid  in  troubleshooting  R7912 
hardware  problems. 
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APPENDIX  C.— TESTSEQ  OPERATIONS  CONTROL  FILE 

The  operator  of  the  Systems  Generated  Flectromagnetic  Pulse 
Transportable  Automated  Recording  System  (STARS)  can  control  the 
data-taking  sequence  and  the  execution  of  all  programs  by  an  indirect 
command  file,  TESTSEQ.CMD,  This  file  is  composed  of  all  the  programs 
used  to  acquire,  process,  and  store  the  data.  When  the  operator  types 
"@DK1 tTESTSEQ"  and  then  a carriage  return  at  the  console  terminal,  the 
complete  directions  for  taking  data  are  printed  at  the  console  display. 
The  instructions  lead  the  operator  through  the  entire  sequence  and 
permit  interactive  control  of  program  execution. 

Following  is  the  TESTSEQ  file.  Reader  familiarity  with  the  command 
language  of  the  monitor  console  routine  of  the  Digital  Equipment  Corp. 
RSx-llM  operating  system  is  a prerequisite  to  understanding  the  sample. 

RUN  ERASE 

;THE  FOLLOWING  IS  AN  OUTLINE  OF  THE  DATA  TAKING  SEQUENCE 

;EVALUATE  DISK  SPACE  AVAILABILITY  (BLKCNT,  VFY) 

.•CREATE  MAIN.DAT  (OUTFIL) 

; RESET  7912/CHANNEL  ERROR  FLAGS  (FLAG) 

;CHECK  FOR  7912 'S  OFF-LINE  (OFFLIN) 

.•ENTER  LOG  INFO  (LOG) 

.•CHECK  LOG  ENTRIES  (SYSCHK) 

.•CORRECT  ANY  BAD  ENTRIES  (LOG,  PRB,  ATN) 

;SET  KNOBS  (OPTIONAL  TV  MODE  (KNOB)) 

.•TAKE  BASELINE  (BASE) 

.•TAKE  CAL  (CAL) 

.•EVALUATE  CAL  (CHKCAL) 

.•ENTER  SHOT  NO.  AND  SIMULATOR  CODE  (SHOTNO) 

;PREPARE  7912' S FOR  DATA  TAKE  (PREDAT) 

;TAKE  DATA  (DATA) 

.•NORMALIZE  AND  SCALE  DATA  (SCALE) 

.•HARD  COPY  RAW  DATA  (RAWCPY) 

; EVALUATE  DATA  QUALITY  AND  SELECT  KEY  POINTS  (MARK) 

.•INPUT  SIMULATOR  INFORMATION  (TABIN) 

;HARD  COPY  SCALED  DATA  (SCACPY) 

.•PRINT  PARAMETER  TABLE  (TABLES) 

; PRINT  SYSTEM  DESCRIPTION  TABLES  (TABLES) 

.•INPUT  USER  COMMENTS  (USRCOM) 

;PUT  SHOT  FILE  ON  DAILY  DATA  TAPE  (PRTNAM,  FLX) 

t 

;TASK  NAMES  ARE  IN  PARENTHESES. 
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.100: 


.110: 

.200: 

.300; 

.310: 

.320: 

.400: 


;MAKE  A COPY  OF  THIS  PAGE  IF  ONE  IS  NOT  AT  HAND 
; PAUSE 
RUN  ERASE 

;TO  ELIMINATE  SUPPLEMENTARY,  EXPLANATORY  TEXT, 
.•ANSWER  THE  FOLLOWING  WITH  N. 

;ASK  DIALOG  EXTENDED  DIALOGUE 
} 

;DISK  SPACE  REQUIREMENTS 
RUN  BLKCNT 

;IFNINS. . .VFY  INS...VFY 
.XQT  VFT  TTO:  = DK1:/FR 
.WAIT 

.ASK  SPACE  IS  THERE  ENOUGH  SPACE 
.IFT  SPACE  .GOTO  200 
.IFF  DIALOG  .GOTO  110 
; DURING  THE  FOLLOWING  PAUSE, 

;MAKE  USE  OF  PIP,  FLX  AND  OTHER  UTILITIES  TO 
; CLEAN  UP  THE  DATA  DISK 
.PAUSE 
.GOTO  100 

RUN  OUTFIL 

.IFT  DIALOG: MAIN. DAT  HAS  NOW  BEEN  CREATED 

t 

;PUT  ATTENUATORS  IN  AUTOMATIC  MODE 
.SETF  REPCAL 
.SETF  REPRED 

RUN  FLAG 
RUN  ERASE 

.IFT  DIALOG:  NOW  CHECKING  FOR  7912 'S  OFF-LINE 
RUN  OFFLIN 

.IFF  DIALOG  .GOTO  310 

;IF  PRESENT  ERROR  CONDITIONS  ARE  NOT  SATISFACTORY 
.•ANSWER  THE  FOLLOWING  WITH  N, 

.ASK  GOOD  GOOD  STATUS 
.IFT  GOOD  .GOTO  400 
.IFF  DIALOG  .GOTO  320 
; DURING  THE  FOLLOWING  PAUSE, 

.•RESOLVE  THE  STATUS  OF  THE  HARDWARE 
.•AND  PREPARE  DECISIONS  FOR  ENABLE/DISABLE. 

.PAUSE 
.GOTO  300 

.IFT  REPCAL  .GOTO  800 
.IFT  REPRED  .GOTO  900 
RUN  LOG 
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.500:  RUN  SYSCHK 

•IFF  DIALOG  .GOTO  510 
;IF  ANY  ENTRIES  WERE  BAD, 

; ANSWER  THE  FOLLOWING  WITH  N. 

.510:  ;ASK  GOOD  ALL  ENTRIES  GOOD 

.IFT  GOOD  .GOTO  600 
RUN  ERASE 

.IFF  DIALOG  .GOTO  520 
.•DURING  THE  FOLLOWING  PAUSE, 

;MAKE  USE  OF  LOG,  PRB  AND  ATN 
;TO  REMOVE  THE  BAD  ENTRIES. 

.-UPON  RESUME,  ENTRIES  WILL  BE  PECHECKED. 
.520:  .PAUSE 

.GOTO  500 

.600:  RUN  ERASE 

.IFF  DIALOG  .GOTO  610 
;IF  USE  OF  THE  TV  MONITORS 
;FOR  KNOB  SETTING  IS  DESIRED, 

; ANSWER  THE  FOLLOWING  WITH  Y. 

.610:  .ASK  TV  TV  MODE 

.IFF  TV  .GOTO  700 

RUN  KNOB 

.IFT  DIALOG;  7912 'S  NOW  IN  TV  MODE 
.•SWITCH  TO  LOWER  INTENSITY 
;THEN  USE  INTERNAL  TRIGGER 

. 700  : ; SET  KNOBS 

.IFT  TV;  RESET  TRIGGER  AND  INTENSITY 
.IFF  DIALOG  .GOTO  710 
.•USE  THE  FOLLOWING  PAUSE. 

; RESUME  WILL  INITIATE  BASELINE  SHOT, 
.710:  .PAUSE 

RUN  BASE 
.SETF  REPCAL 
,SETF  REP RED 
.IFF  DIALOG  .GOTO  720 
;IF  UNDESIRABLE  ERRORS  HAVE  OCCURRED, 

; ANSWER  THE  FOLLOWING  WITH  N. 

;A  Y WILL  BRING  A CAL  SHOT  IMMEDIATELY 
.720;  .ASK  GOOD  SATISFACTORY  RESULTS 

.IFF  GOOD  .GOTO  300 

.800 ; RUN  CAL 

RUN  CHKCAL 
RUN  ERASE 

.IFF  DIALOG  .GOTO  810 

;IF  THE  CAL  DATA  ARE  NOT  ACCEPTABLE 
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;0R  UNWANTED  ERRORS  HAVE  OCCURRED, 

; ANSWER  THE  FOLLOWING  WITH  N. 

.800;  .ASK  GOOD  SATISFACTORY  RESULTS 

.IFT  GOOD  .GOTO  900 
.IFF  DIALOG  .GOTO  820 

;IF  CHANGES  TO  SYSCON  (OTHER  THAN  FLAGS) 
;NEED  NOT  BE  MADE  AND  IF  A BASELINE 
;SHOT  NEED  NOT  BE  REPEATED, 

; ANSWER  THE  FOLLOWING  WITH  Y. 

.820:  .ASK  REPCAL  REDO  CAL  ONLY 

.SETF  REPRED 
.GOTO  300 

.900:  RUN  ERASE 

RUN  SHOTNO 
RUN  ERASE 
RUN  PREDAT 

..IFF  DIALOG  .GOTO  910 
:7912's  NOW  READY  FOR  DATA  RUN 
;IF  ANY  UNWANTED  ERRORS  HAVE  OCCURRED, 
.•ANSWER  THE  FOLLOWING  WITH  N. 

.910  .ASK  GOOD  SATISFACTORY  RESULTS 

.IFT  GOOD  .GOTO  1000 
.IFF  DIALOG  .GOTO  920 

;IF  CHANGES  TO  SYSCON  (OTHER  THAN  FLAGS) 
;NEED  NOT  BE  MADE  AND  IF  BASELINE  AND 
;CAL  NEED  NOT  BE  REPEATED, 

ANSWER  THE  FOLLOWING  WITH  Y. 

.920:  -ASK  REPRED  REDO  PREDAT  ONLY 

.SETF  REPCAL 
.GOTO  300 

.1000;  RUN  ERASE 

.IFF  DIALOG  .GOTO  1010 
;A  SHORT  TIME  AFTER  ANSWERING  THE 
.•FOLLOWING  QUESTION  WITH  Y,  THE  SYSTEM 
.•WILL  BE  AWAITING  A TRIGGER  PULSE. 

; ANSWER  WITH  N ONLY  IF  YOU  WISH 

;TO  BACKTRACK  TO  THE  PREVIOUS  QUESTION 

;AND  BRANCH  FURTHER  BACK  FROM  THERE. 

;IF  THE  SIMULATOR  ABORTS, 

.•MANUALLY  TRIGGER  THE  SYSTEM 
.-AND  ANSWER  THE  SUBSEQUENT  "ABORT?" 

.•WITH  y TO  LOOP  BACK  TO  RECOVER 
.1010;  .ASK  TRIG  NEAR  TRIGGER  TIME 
.IFF  TRIG  .GOTO  910 
RUN  DATA 

.IFT  DIALOG;  DATA  SHOT  TAKEN 
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.ASK  ABORT  ABORT 
.IFT  ABORT  .GOTO  900 

RUN  SCALE 
RUN  RAWCPy 
RUN  MARK 
RUN  ERASE 
RUN  TAB IN 
RUN  SCACPY 
RUN  TABLES 

RUN  ERASE 

;ONCE  USER  COMMENTS  HAVE  BEEN  FILED 
; (SEE  XMTR  LOG  FOR  NEXT  SHOT) , 

;RUN  THE  TASK  USRCOM. 

;THE  SHOT  FILE  WILL  THEN  BE  COMPLETE 

;AND  SHOULD  BE  TRANSFERRED 

;TO  THE  DAILY  DATA  TAPE  WITH  FLX. 

;AS  AN  AID,  RUNNING  THE  TASK  PRTNAM 
.•WILL  GIVE  THE  ACTUAL  NAME 
;OF  THE  PRESENT  SHOT  FILE. 
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APPENDIX  D,— SYMDEF  MACRO  ENTRIES 


SYMDEF  is  a macro  that  is  called  by  virtually  every  program  in  the 
SKYNET  Applications  Software  Package  (SASP) . Its  function  is  to  define 
SASP  parameters. 


Entry 

Assigned 

value 

Definition 

ADRCBl 

164000 

UNIBUS  address,  Tektronix  R7912  digitizer  controller 

ADRCB2 

165000 

UNIBUS  address,  digitizer  controller  card  No.  2 

ADRCB3 

166000 

UNIBUS  address,  digitizer  controller  card  No.  3 

ADRCB4 

167000 

UNIBUS  address,  digitizer  controller  card  No.  4 

ARMBIT 

000020 

Digitizer  status  bit  for  armed  sweep 

ATNDLY 

000010 

Offset  for  device  delay  in  ATNCAL  PSECT  (program 
section) 

ATNERR 

000004 

Bit  for  transmitter  attenuator  setting  verification 
error 

ATNGN 

000004 

Offset  for  device  gain  in  ATNCAL  PSECT 

ATNID 

000000 

Offset  for  device  identification  (ID)  in  ATNCAL  PSECT 

ATNMDL 

000014 

Offset  for  device  model  in  ATNCAL  PSECT 

ATNSER 

000024 

Offset  for  device  manufacturer's  serial  number  in 
ATNCAL 

BADBIT 

010000 

Bit  to  indicate  bad  (incorrect)  digitizer  data  word; 
set  by  software 

BLMERR 

001000 

Bit  for  digitizer  bloom  error 

BLMFAC 

000004 

Bloom  multiplication  factor  for  average  to  center  of 
trace  (ATC)  routines 

BLMMAX 

000017 

Maximum  allowed  bloom 

BLMMIN 

000002 

Minimum  allowed  bloom 

BZYBIT 

020000 

Digitizer  status  bit  for  busy  condition 
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Assigned 

Entry  value  Definition 

BZYERR  000020  Bit  for  digitizer  busy  error 

CALERR  000010  Channel  error  bit  for  bad  (be low- standard) 

calibration  trace 

CHNATN  000036  Offset  for  transmitter  attenuator  setting  in  channel 

entry  in  SYSCON  (COMMON  area  image  of  SYSCON.DAT 
file) 

CHNATl  000010  Offset  for  attenuator  ID  in  channel  entry  in  SYSCON 

CHNAT2  000030  Offset  for  device  ID  in  channel  entry  in  SYSCON 

CHNBIS  000020  Offset  for  x-ray  detector  (XRD)  bias  in  channel  entry 

in  SYSCON 

CHNDGS  000052  Offset  for  list  of  digitizers  associated  with  channel 

in  channel's  entry  in  SYSCON 

CHNDLG  000060  Offset  for  data  linlc  gain  in  channel  entry  in  SYSCON 

CHNDLY  000070  Offset  for  overall  channel  delay  in  channel  entry  in 

SYSCON 

CHNFLG  000000  Offset  for  channel  error  flag  in  channel  entry  in 

SYSCON 

CHNNDG  000050  Offset  for  niimJaer  of  digitizers  associated  with 

channel  entry  in  SYSCON 

CHNPRA  000044  Offset  for  postreceiver  gain  value  in  channel  entry 

in  SYSCON 

CHNPRB  000014  Offset  for  probe/sensor  ID  in  channel  entry  in  SYSCON 

CHNPRD  000040  Offset  for  postreceiver  cable  delay  in  channel  entry 

in  SYSCON 

CHNPXD  000024  Offset  for  pretransmitter  cable  delay  in  channel 

entry  in  SYSCON 

CHNSPR  000064  Offset  for  scale  factor  in  channel  entry  in  SYSCON 

CHNTPN  000002  Offset  for  test  point  name  in  channel  entry  in  SYSCON 

CHNXMT  000034  Offset  for  transmitter  address  (or  numlDer)  in  channel 

entry  in  SYSCON 
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Entry 

Assigned 

value 

APPENDIX  D 

Definition 

CHIBIT 

000100 

Digitizer  status  bit  for  channel  No.  1 selected 
dual-channel  plug-in  unit  in  digitizer) 

(for 

CLKBGN 

000031 

Command  to  start  programmeible  clock  for  calorimeter 
data-taking  mode 

CLRBIT 

000216 

Digitizer  status  bits  for  complement  of  initialized 
(cleared)  condition 

CMDALL 

002006 

Digitizer  command  to  enable  data  taking  on 
channels  at  dual  vertical  plug-in 

both 

CMDARM 

002040 

Digitizer  command  to  arm  single  sweep 

CMDCHl 

002013 

Digitizer  command  to  select  channel  No.  1 of 
input  to  digitizer 

dual 

CMDCH2 

002003 

Digitizer  command  to  select  channel  No.  2 of 
input  to  digitizer 

dual 

CMDCLR 

004000 

Digitizer  command  to  initialize  registers 

CMDDGT 

002015 

Digitizer  command  to  switch  to  digital  mode 

CMDDTA 

002100 

Digitizer  command  to  start  sending  data 

CMDERR 

000040 

Bit  for  digitizer  command  execution  error 

CMDGRT 

002014 

Digitizer  command  to  enable  graticule 

OIDKRO 

002002 

Digitizer  command  to  enable  sending  knob  readout 
information  immediately  following  data 

CMDLCK 

002017 

Digitizer  command  to  lock  memory  (write-protect) 

CMDNGT 

002004 

Digitizer  command  to  disable  graticule 

CMDNKO 

002012 

Digitizer  command  to  inhibit  sending  of  knob  readout 
information 

CMDPEM 

002016 

Digitizer  command  to  enable  channel  selection 
input  only) 

(dual 

CMDSTR 

002020 

Digitizer  command  to  request  status 

CMDTV 

002005 

Digitizer  command  to  switch  to  television  mode 
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Assigned 


Entry 

value 

Definition 

CMDUNL 

002007 

Digitizer  command  to  unlock  memory  (remove 

write-protect ) 

CNTBZY 

000036 

Number  of  seconds  for  time-out  on  busy  status  for 
digitizer 

CNTCMD 

000036 

Number  of  seconds  for  time-out  on  command  for 
digitizer 

CNTXMT 

000036 

Number  of  seconds  for  transmitter  warm-up  clock 

CRGCLK 

172544 

UNIBUS  address  of  count  register  of  programmable 
clock 

CSBCLK 

172542 

UNIBUS  address  of  count  set  buffer  of  programmable 
clock 

CSRCLK 

172540 

UNIBUS  address  of  command  and  status  register  of 
programmable  clock 

DGTBIT 

000200 

Digitizer  status  bit  for  digital  mode 

DIGADR 

000000 

Offset  for  digitizer  UNIBUS  address  in  digitizer's 
entry  in  SYSCON 

DIGBAS 

000014 

Offset  for  requested  baseline  trace  position  in 
digitizer  entry  in  SYSCON 

DIGBLM 

000012 

Offset  for  bloom  in  digitizer  entry  in  SYSCON 

DIGCHN 

000002 

Offset  for  associated  channel  number  in  digitizer's 
entry  in  SYSCON 

DIGPLG 

000004 

Offset  for  digitizer  error  flag  in  digitizer's  entry 
in  SYSCON 

DIGHRZ 

000006 

Offset  for  requested  horizontal  sweep  rate  setting  in 
digitizer's  entry  in  SYSCON 

DIGVRT 

000010 

Offset  for  requested  vertical  sensitivity  setting  in 
digitizer's  entry  in  SYSCON 

DISERR 

000002 

Bit  for  digitizer  or  channel  disabled  error 

DTAMSK 

177000 

Mask  for  extraneous  bits  in  digitizer  data  word 

GRTBIT 

000010 

Digitizer  status  bit  for  graticule  enabled 
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Entry 

value 

Definition 

HDRASC 

000014 

Offset  for  American  Stcindard  Code  for  Information 

Interchange  shot  number  in  SYSCON  header 

HDRCLE 

000144 

Offset  for  calorimeter  error  flag  in  SYSCON  header 

HDRCLl 

000130 

Offset  for  channel  A calorimeter  result  in  SYSCON 
header 

HDRCL2 

000134 

Offset  for  channel  B calorimeter  result  in  SYSCON 
header 

HDRCOM 

000070 

Offset  for  simulator  comment  in  SYSCON  header 

HDRCON 

000046 

Offset  for  pulser  configuration  code  in  SYSCON  header 

HDRDAT 

000000 

Offset  for  trigger  date  in  SYSCON  header 

HDRIDP 

000064 

Offset  for  current  diode  peak  value  in  SYSCON  header 

HDRLEV 

000050 

Offset  for  pulser  output  level  in  SYSCON  header 

HDRNBK 

000126 

Offset  for  number  of  blocks  in  MAIN.DAT  or  shot  file 
in  SYSCON  header 

HDRNCB 

000024 

Offset  for  number  of  digitizer  controller  boards  in 
system  in  SYSCON  header 

HDRNCH 

000026 

Offset  for  number  of  channels  in  system  in  SYSCON 
header 

HDRNDG 

000022 

Offset  for  number  of  digitizers  in  system  in  SYSCON 
header 

HDRMSl 

000140 

Offset  for  number  of  samples  taken  on  calorimeter 
channel  A in  SYSCON  header 

HDRNS2 

000142 

Offset  for  number  of  samples  taken  on  calorimeter 
channel  B in  SYSCON  header 

HDRSCV 

C00050 

Offset  for  simulator  charging  voltage  in  SYSCON 
header 

HDRSHN 

000020 

Offset  for  Integer  shot  number  in  SYSCON  header 

HDRSIM 

000044 

Offset  for  simulator  code  in  SYSCON  header 

HDRTIM 

000006 

Offset  for  trigger  time  in  SYSCON  header 
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Assigned 
Entry  value 

HDRVAC  000054 

HDRVDP  000060 

HDRWIR  000046 

HZMSK  001000 

INTBIT  OOOIOC 
KROERR  000400 
KROMSK  177600 

LKDBIT  000004 

MISMAX  000012 

NEGMSK  100000 

NOBERR  020000 
NOCERR  040000 
NODERR  100000 
NPTMIN.  000144 

NRDBLK  000010 

NSCBLK  000005 
OFFERR  000001 
OVFERR  000004 
PRBBLN  000026 
PRBCON  000054 


Definition 

Offset  for  tank  vacuum  in  SYSCON  header 

Offset  for  voltage  diode  peak  value  in  SYSCON  header 

Offset  for  wire  type  code  in  SYSCON  header 

Bit  set  to  indicate  horizontal  word  in  raw  digitizer 
data 

Enable  bit  for  digitizer  interrupts 
Bit  for  digitizer  knob  readout  error 

Mask  for  extraneous  bits  in  digitizer  knob  readout 
word 

Digitizer  status  bit  for  locked  memory 
(write-protect) 

Maximum  number  of  mistake?^i  in  digitizer  read 
verification  allowed  before  another  reading  is 
requested 

Bit  set  to  indicate  knob  readout  word  in  digitizer 
data 

Bit  set  for  no  digitizer  baseline  trace  error 

Bit  set  for  no  digitizer  calibration  trace  error 

Bit  set  for  no  digitizer  data  trace  error 

Minimum  number  of  points  allowed  for  correct  bloom 
calculation 

Number  of  disc  blocks  required  for  raw  digitizer  data 
trace  storage 

Number  of  disc  blocks  required  for  SYSCON 

Bit  set  for  digitizer  or  transmitter  off-line  error 

Bit  set  for  digitizer  data  overflow  error 

Offset  for  balun  number  in  PRBCAL  PSECT 

Offset  for  connector  in  PRBCAL  PSECT 
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Assigned 

value 


Definition 


APPENDIX  D 


Entry 

PRBDLY 

PRBFLG 

PRBID 

PRBMDL 

PRBMT 

PRBPAR 

PRBSER 

PRBTF 

PRBUNT 

PRICLK 

PRIDIG 

PRITRG 

RAWMAX 

RAWMIN 

REMBIT 

SGLBIT 

3HFERR 

SHFMAX 

SIZCHN 

SIZDIG 

SIZHDR 

TANMAX 

n*CERR 


000010 

000024 

000000 

000034 

000030 

000064 

000044 

000004 

000014 

000300 

000300 

000300 

003720 

001750 

000002 

000040 

002000 

000015 

000100 

000030 

000240 

000080 

000100 


Offset  for  probe  delay  in  PRBCAL  PSECT 
Offset  for  integration  flag  in  PRBCAL  PSECT 
Offset  for  probe  sensor  ID  in  PRBCAL  PSECT 
Offset  for  model  in  PRBCAL  PSECT 
Offset  for  measurement  type  in  PRBCAL  PSECT 
Offset  for  parameter  in  PRBCAL  PSECT 
Offset  for  serial  number  in  PRBCAL  PSECT 
Offset  for  transfer  function  in  PRBCAL  PSECT 
Offset  for  units  in  PRBCAL  PSECT 
Priority  for  clock  interrupts 
Priority  for  digitizer  interrupts 
Priority  for  trigger  interrupts 

Maximum  number  of  raw  digitizer  data  words  allowed 

Minimum  number  of  raw  digitizer  data  words  allowed 

Digitizer  status  hit  for  enabled  channel  selection 

Digitizer  status  bit  for  single  sweep  mode 

Bit  set  for  digitizer  baseline  trace  positioning 
error 

Maximum  allowed  number  of  points  between  digitizer 
baseline  trace  position  and  requested  position 

Size  in  bytes  of  channel  entry  in  SYSCON 

Size  in  bytes  of  digitizer  entry  in  SYSCON 

Size  in  bytes  of  SYSCON  header 

Maximum  allowed  absolute  value  of  slope  between  two 
points  of  ATC  of  digitizer  trace 

Bit  set  for  digitizer  failure-to-trigger  error 
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Assigned 
Entry  value 

TRYMAX  000012 

UNFERR  000010 
UNTMSK  177707 

VBNBAS  000030 

VBNCAL  000032 

VBNPAR  000040 

VBNRAW  000034 

VBNSCA  000036 

VBNUSR  000042 

VECCBl  000374 
VECCB2  000370 
VECCB3  000364 
VECCB4  000360 
VECCLK  000104 
VECTRG  000334 
VFYERR  000200 
XCHCAL  000014 

XCHDLY  000010 
XCHFBR  000002 


Definition 

Maximum  allowed  number  of  attempts  at  verified  read 
of  digitizer 

Bit  set  for  digitizer  data  underflow  error 

Mask  for  digitizer  \init  number  in  controller  status 
register  (upon  interrupt)  of  digitizer  controller 
card 

Virtual  block  number  for  beginning  of  baseline  trace 
storage  in  MAIN.DAT  or  shot  file 

Virtual  block  number  for  beginning  of  calibration 
trace  storage  in  MAIN.DAT  or  shot  file 

Virtual  block  number  for  beginning  of  parameter 
storage  in  MAIN.DAT  or  shot  file 

Virtual  block  number  for  beginning  of  raw  data  trace 
storage  in  MAIN.DAT  or  SHOT.DAT  file 

Virtual  block  number  for  beginning  of  scaled  data 
trace  storage  in  MAIN.DAT  or  shot  file 

Virtual  block  number  for  beginning  of  user  comment 
storage  in  MAIN.DAT  or  shot  file 

Vector  address  for  digitizer  controller  card  No.  1 

Vector  address  for  digitizer  controller  card  No.  2 

Vector  address  for  digitizer  controller  card  No.  3 

Vector  address  for  digitizer  controller  card  No.  4 

Vector  address  for  programmable  clock 

Vector  address  for  trigger 

Bit  set  for  digitizer  read  verification  error 

Offset  for  calibration  generator  output  level  in 
XCHCAL  PSECT 

Off set. for  delay  in  XCHCAL  PSECT 
Offset  for  fiber  number  in  XCHCAL  PSECT 


86 


Entry 

XCHREC 

XCHXMT 

XHDBLN 

XHDDRl 

XHDDR2 

XHDDTF 

XHDDTV 

XHDDTl 

XHDNCH 


Assigned 

value 

000004 

000000 

000030 

000010 
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Definition 

Offset  for  receiver  number  in  XCHCAL  PSECT 

Offset  for  transmitter  address  number  in  XCHCAL  PSECT 

Offset  for  balun  insertion  loss  table  in  XCHHDR  PSECT 

Offset  for  first  part  of  trigger  path  delay  (At  . ) 
in  XCHHDR  PSECT  ^1 


900014  Offset  for  second  part  of  trigger  path  delay 

(At^  . ) in  XCHHDR  PSECT 

trig2 


000020  Offset  for  fiducial  path  delay  (^^f  XCHHDR 

PSECT  ^ 


000024  Offset  for  vertical  plug-in  delay  (At  ) in  XCHHDR 
PSECT 


000004  Offset  for  source  to  XRD  transit  time  in  XCHHDR  PSECT 

000000  Offset  for  number  of  channels  entered  in  XCHCAL.DAT 

file  in  XCHHDR  PSECT 
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APPENDIX  E. — LIBRARIES:  OBJECT  AND  MACRO 


To  facilitate  program  development,  maintenance  and  understcuiding, 
similar  subroutines  and  macros  are  grouped  together  into  object  or  macro 
libraries  resident  on  the  system  disc. 


Name  Contents 


Purpose 


ERROR  CHNERR 

(object)  DCDBIT 
DIGERR 
DISABL 
DSKERR 
ERRNUM 
lASCII 
LSTERR 
.RSTR 
.SAVE 

HANDLE  BUSY 

(object)  CHKTRG 
CLRCBD 
CMDDIG 
FLGPTS 
INTABL 
INTDIG 
RDIG 
SETVEC 


List  and  flag  digitizer  and  channel  errors 


Digitizer  handling  routines;  many  reference 
error  reporting  routines  in  library  ERROR 


INPUT  ANSWER  Terminal  input  routines 

(object)  ASDCD 
FIELD 
FLDCD 
FLOTE 
FXDCD 
IFICKS 
INPUT 


NORMAL  BASATC  Normalization  routines 

(object)  CALATC 
DATATC 
ELIMPT 
EXTRAP 
INTRP 
ISBASE 
QKELIM 
QKLNTP 
SUBASE 
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Name 

SKYNET 

(macro) 

RRPMAC 

(macro) 


E 

Contents  Purpose 

RDSECT  General,  system-wide  macros 

SCSECT 

SYMDEF 

ADR  General  purpose  macros 

CALL 

CC»1 

CMPD 

FIX 

FLOAT 

FPA 

FPC 

FPE 

FPS 

FSTK 

FSTO 

HDR 

MIN 

MOVF 

MOVP 

SCRPT 

SET 

ST 

STE 

STZ 
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DISTRIBUTION 


DEFENSE  DOCUMENTATION  CENTER 
CAMERON  STATION,  BUILDING  5 
ALEXANDRIA,  VA  22314 
ATTN  DDC-TCA  (12  COPIES) 

COMMANDER 

USA  RSCH  S STD  GP  (EUR) 

BOX  65 

FPO  NEW  YORK  09510 
ATTN  LTC  JAMES  K.  KENNEDY,  JR. 

CHIEF,  PHYSICS  & MATH  BRANCH 

COMMANDER 

US  ARMY  MATERIEL  DEVELOPMENT 
& READINESS  COMMAND 
5001  EISENHOWER  AVENUE 
ALEXANDRIA,  VA  22333 
ATTN  DRXAM-TL,  HQ  TECH  LIBRARY 

COMMANDER 

US  ARMY  ARMAMENT  MATERIEL 
READINESS  COMMAND 
ROCK  ISLAND  ARSENAL 
ROCK  ISLAND,  IL  61201 
ATTN  DRSAR-ASF,  FUZE  & 

MUNITIONS  SPT  DIV 

COMMANDER 

USA  MISSILE  & MUNITIONS 
CENTER  & SCHOOL 
REDSTONE  ARSENAL,  AL  35809 
ATTN  ATSK-CTD-F 

DIRECTOR 

DEFENSE  COMMUNICATIONS  AGENCY 
DEPT  OF  DEFENSE 
WASHINGTON,  DC  20305 
ATTN  PLANS  S PROGRAMS  DIRECTORATE 
ATTN  OFC  OF  SYS  ENGINEERING 
ATTN  TECH  LIBRARY 
ATTN  NMR 

DIRECTOR 

DEFENSE  NUCLEAR  AGENCY 
WASHINGTON,  DC  20305 
ATTN  PETER  HAAS,  DEP  DIR, 

SCIENTIFIC  TECHNOLOGY 
ATTN  RADIATION  DIRECTORATE 
ATTN  ELECTRONIC  VULNERABILITY 
DIV  (RAEV) 

ATTN  ANALYSIS  & PROGRAMS  DIRECTORATE 
ATTN  TECHNICAL  LIBRARY  (APTL) 

ATTN  VULNERABILITY  DIRECTORATE 
ATTN  INFORMATION  SYSTEMS  DIV  (VLIS) 
ATTN  DDST 

ATTN  TITL  TECH  LIBRARY 
ATTN  TISI  ARCHIVES 


DIRECTOR  OF  DEFENSE  RESEARCH 
& ENGINEERING 
WASHINGTON,  DC  20301 
ATTN  DEP  DIR  (TEST  fi  EVALUATION) 

ATTN  ASST  DIR  (ENG  TECHNOLOGY) 

COMMANDER 
FIELD  COMMAND 
DEFENSE  NUCLEAR  AGENCY 
KIRTLAND  AFB,  NM  87115 
ATTN  FCSD-A4,  TECH  REF  BR 
ATTN  D.  SHAMBLIN 

COMMANDER 

AF  WEAPONS  LAB,  AFSC 
KIRTIJtfID  AFB,  NM  87117 
ATTN  SE,  NUCLEAR  SYS  DIV 
ATTN  EL,  ELECTRONICS  DIV 
ATTN  EL,  ELECTRONICS  DIV 
ATTN  ELC,  COMM  & SATELLITE  BR 
ATTN  LR,  LASER  DEV  DIV 
ATTN  LRL,  LASER  DEVICE  BR 

DIRECTOR 

DEFENSE  ADVANCED  RESEARCH  PROJECT  AGENCY 
ARCHITECT  BUILDING 
1400  WILSON  BLVD 
ARLINGTON,  VA  22209 
ATTN  NMR 

CHIEF 

LIVERMORE  DIVISION  FIELD  COMMAND,  DNA 
LAWRENCE  LIVERMORE  LABORATORY 
P.O.  BOX  808 
LIVERMORE,  CA  94550 
ATTN  FCPRL 

COMMANDER 

REDSTONE  SCIENTIFIC  INFORMATION  CTR 
US  ARMY  MISSILE  COMMAND 
REDSTONE  ARSENAL,  AL  35809 
ATTN  CHIEF,  DOCUMENTS 

CHIEF 

US  ARMY  COMMUNICATIONS  SYS  AGENCY 
FORT  MONMOUTH,  NJ  07703 
ATTN  SCCM-AD-SV,  LIBRARY 

COMMANDER 

US  ARMY  ELECTRONICS  COMMAND 
FORT  MONMOUTH,  NJ  07703 
ATTN  DRSEL 

COMMANDER 

US  ARMY  FOREIGN  SCIENCE  fi  TECH  CTR 
220  7TH  STREET,  NE 
CHARLOTTESVILLE,  VA  22901 
ATTN  DRXST-ISl 
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DISTRIBURION  (Cont'd) 


DIRECTOR 

NAVAL  RESEARCH  LABORATORY 
WASHINGTON,  DC  20375 
ATTN  CODE  7756,  J.  DAVIS 

COMMANDER 

NAVAL  SURFACE  WEAPONS  CENTER 
WHITE  OAK,  SILVER  SPRING,  MD  20910 
ATTN  CODE  WA501,  NAVY  NUC  PRGMS  OFF 

AF  WEAPONS  LABORATORY,  AFSC 
KIRTLAND  AFB,  NM  87117 
ATTN  SUL 

AF  WEAPONS  LABORATORY,  AFSC 
KIRTLAND  AFB,  NM  87117 
ATTN  NTS 

AF  WEAPONS  LABORATORY,  AFSC 
KIRTLAND  AFB,  NM  87117 
ATTN  DYC 

COMMANDER 

ROME  AIR  DEVELOPMENT  CENTER,  AFSC 
HANSCOM  AFB,  MA  01731 
ATTN  EDWARD  A.  BURKE 

SAMSO/DY 

POST  OFFICE  BOX  92960 
WORLDWAY  POSTAL  CENTER 
LOS  ANGELES,  CA  90009 
ATTN  DYS  (TECHNOLOGY) 

SAMSO/MN 

NORTON  AFB,  CA  92409 
ATTN  MNNG  (MINUTEMAN) 

ATTN  MNNH  (MINUTEMAN) 

SAMSO/SK 

POST  OFFICE  BOX  92960 
WORLDWAY  POSTAL  CENTER 
LOS  ANGELES,  CA  90009 
ATTN  SKF  (SPACE  COMM  SYSTEMS) 

SAMSO/XR 

POST  OFFICE  BOX  92960 
WORLDWAY  POSTAL  CENTER 
LOS  ANGELES,  CA  90009 
ATTN  XRS  (DEVELOPMENT  PLANS) 

UNIVERSITY  OF  CALIFORNIA 
LAWRENCE  LIVERMORE  LABORATORY 
P.O.  BOX  808 
LIVERMORE,  CA  94550 
ATTN  TECH  INFO  DEPT  L-3 

NASA 

LEWIS  RESEARCH  CENTER 
21000  BROOKFARK  ROAD 
CLEVELAND,  OH  44135 
ATTN  LIBRARY  (NO  R/D) 
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